Optionen aus der angegebenen Umgebungsvariablen oder Konfigurationsdatei einlesen. Weitere Hinweise finden Sie unter Konfigurationsdateien verwenden.

Wenn Sie Kennwörter oder andere Informationen in einer Konfigurationsdatei schützen möchten, können Sie das Dienstprogramm zum Verschleiern von Dateien verwenden. Weitere Hinweise finden Sie unter Dienstprogramm zum Verschleiern von Dateien (dbfhide).

Verbindung mit einer bestehenden Datenbank aufnehmen und die Daten direkt in sie entladen, wodurch der Vorgang einer Datenbankentladung und des Neuladens der Ergebnisse in eine bestehende Datenbank kombiniert wird. Diese Option wird unter Windows Mobile nicht unterstützt.

Beispielsweise könnten Sie eine neue Datenbank mit dem Dienstprogramm Initialisierung erstellen und sie dann mit dieser Option wiederladen. Diese Methode ist nützlich, wenn Sie Initialisierungsoptionen ändern wolen.

Der folgende Befehl (in einer Zeile eingegeben) lädt eine Kopie der Datenbank c:\mydata.db in eine bestehende Datenbankdatei namens c:\mynewdata.db:

dbunload -c "UID=DBA;PWD=sql;DBF=c:\mydata.db"
         -ac "UID=DBA;PWD=sql;DBF=c:\mynewdata.db"

Wenn die ursprüngliche Datenbank mit der Version 9 oder früher von SQL Anywhere erstellt wurde und die neue Datenbank noch nicht läuft, müssen Sie den Datenbankservernamen mit der Option -ac angeben. Zum Beispiel:

dbunload -c "UID=DBA;PWD=sql;DBF=c:\mydata.db"
          -ac "UID=DBA;PWD=sql;DBF=c:\mynewdata.db;ENG=newserver"

Wenn Sie diese Option verwenden, wird keine Zwischenkopie der Daten auf der Festplatte angelegt. Sie geben daher im Befehl kein Entladeverzeichnis an. Dies bietet größere Sicherheit für Ihre Daten.

Die Vorgänge "Entladen einer Datenbank", "Erstellen einer neuen Datenbank" und "Laden der Daten" mit dieser Option kombinieren. Diese Option wird unter Windows Mobile, oder wenn Sie Datenbanken der Version 9 oder früher unter Mac OS X für Intel neu aufbauen, nicht unterstützt.

Die Optionen, die Sie bei der Erstellung der Quell-Datenbank angegeben haben, werden verwendet, um die neue Datenbank zu erstellen. Sie können aber die Initialisierungsoptionen ändern, indem Sie andere unterstützte dbunload-Optionen eingeben (wie -ap zum Ändern der Seitengröße oder -et zur Aktivierung der Tabellenverschlüsselung).

Der folgende Befehl (in einer Zeile eingegeben) erstellt zum Beispiel eine neue Datenbankdatei namens mydatacopy.db und kopiert das Schema und die Daten von mydata.db hinein:

dbunload -c "UID=DBA;PWD=sql;DBF=c:\mydata.db"
         -an c:\mydatacopy.db

Wenn Sie diese Option verwenden, wird keine Zwischenkopie der Daten auf der Festplatte angelegt. Sie geben daher im Befehl kein Entladeverzeichnis an. Dies bietet größere Sicherheit für Ihre Daten.

Beim Erstellen der neuen Datenbank wird an den DBSpace-Dateinamen ein "R" angehängt, um Dateinamenskonflikte zu vermeiden, wenn die DBSpace-Datei für die neue Datenbank in demselben Verzeichnis wie der DBSpace für die ursprüngliche Datenbank erstellt wird. Beispiel: Wenn eine entladene Datenbank einen DBSpace namens "library" in der Datei library.db hat, lautet der library-DBSpace für die neue Datenbank library.dbR.

Die mit der Option -an angegebene Datei ist relativ zum Datenbankserver.

Eine neue Datenbank mit denselben Einstellungen erstellen wie bei der alten Datenbank, neu laden und die alte Datenbank ersetzen. Sie können aber die Initialisierungsoptionen ändern, indem Sie andere unterstützte dbunload-Optionen eingeben (wie -ap zum Ändern der Seitengröße oder -et zur Aktivierung der Tabellenverschlüsselung).

Wenn Sie diese Option verwenden, darf es keine anderen Verbindungen zu der Datenbank geben und die Datenbankverbindung muss lokal (nicht über ein Netzwerk) aufgenommen werden. Diese Option wird unter Windows Mobile, oder wenn Sie Datenbanken der Version 9 oder früher unter Mac OS X für Intel neu aufbauen, nicht unterstützt.

Wenn Sie Verzeichnis angeben, werden die Transaktionslog-Offsets für die Replikation zurückgesetzt und das Transaktionslog wird von der alten Datenbank in das angegebene Verzeichnis verschoben. Das benannte Verzeichnis muss das Verzeichnis sein, das die alten Transaktionslogs enthält, die vom Nachrichtenagenten und Replication Agent verwendet werden. Die Transaktionslog-Verarbeitung findet nur statt, wenn die Datenbank in einer Replikation verwendet wird: Wenn es keinen SQL Remote-Publikationseigentümer oder keine LTM-Überprüfung gibt, wird das alte Transaktionslog nicht benötigt und daher gelöscht, anstatt in das angegebene Verzeichnis kopiert zu werden. Weitere Hinweise finden Sie unter Sichern von Datenbanken in einer Synchronisations- und Replikationsumgebung.

Beim Erstellen der neuen Datenbank wird an den DBSpace-Dateinamen ein "R" angehängt, um Dateinamenskonflikte zu vermeiden, wenn die DBSpace-Datei für die neue Datenbank in demselben Verzeichnis wie der DBSpace für die ursprüngliche Datenbank erstellt wird. Beispiel: Wenn eine entladene Datenbank einen DBSpace namens "library" in der Datei library.db hat, lautet der library-DBSpace für die neue Datenbank library.dbR.

Wenn Sie eine verschlüsselte Datenbank neu aufbauen, muss der Chiffrierschlüssel für die ursprüngliche und die neue Datenbank derselbe sein.

Wenn Sie die -ar-Option verwenden, werden die Datenbankkürzungspunkt auf Null zurückgesetzt.

Verbindungsparameter für die Quelldatenbank angeben. Eine Beschreibung der Verbindungsparameter entnehmen Sie dem Abschnitt Verbindungsparameter. Die Benutzer-ID muss über DBA- Berechtigungen verfügen, damit der Benutzer mit Sicherheit die Berechtigungen für alle Tabellen in der Datenbank besitzt.

Die folgende Anweisung entlädt zum Beispiel die Beispieldatenbank und verbindet sich unter Verwendung der Benutzer-ID "DBA" und des Kennworts "sql": Die Daten werden in das Verzeichnis c:\extract entladen.

dbunload -c "DBF=Beispielverzeichnis\demo.db;UID=DBA;PWD=sql" c:\unload

Hinweise zum Beispielverzeichnis finden Sie unter Beispielverzeichnis.

Anzeige der CREATE DATABASE-Anweisung oder des dbinit-Befehls im Meldungsfenster des Servers, um eine Datenbank zu erstellen, die mit der entladenen Datenbank identisch ist. Wenn auch die Option -an angegeben wird, ist der angezeigte Befehl derjenige mit dem die neue Datenbank erstellt wird.

Wenn die Anweisung oder der Befehl für eine bestehende Datenbank mit starker Verschlüsselung (Option -an ist nicht angegeben) angezeigt wird, kann der Chiffrierschlüssel aus der Datenbank nicht bezogenen werden und daher wird ein Fragezeichen (?) in der ENCRYPTED-Klausel oder der Option -ek angezeigt.

Erzwingt eine Neuberechnung aller berechneten Spalten in der Datenbank. Standardmäßig werden berechnete Spalten nicht neu berechnet. Wenn die Option -dc angegeben ist, wird dem reload.sql-Skript ein neuer Abschnitt hinzugefügt, um berechnete Spalten neu zu berechnen. Es werden Anweisungen der folgenden Form hinzugefügt.

ALTER TABLE "owner"."Tabellenname"
ALTER "Berechnete_Spalte" SET COMPUTE (compute_Ausdruck);

Wenn Ihre Tabellen Kontext-abhängige berechnete Werte enthalten, wie z.B. CURRENT DATE, wird empfohlen, dass Sie die ALTER TABLE-Anweisung und nicht die Option -dc verwenden, um berechnete Spaltenwerte neu zu berechnen. Weitere Hinweise finden Sie unter ALTER TABLE-Anweisung.

Die angegebenen Dateien aus der reload.sql-Datei ausschließen. Tabellennamen berücksichtigen nie die Groß- und Kleinschreibung, auch in Datenbanken, die die Groß- und Kleinschreibung berücksichtigen.

Eine Datei reload.sql, die mit der Option -e erstellt wurde, darf nicht benutzt werden, um eine Datenbank neu zu erstellen, weil die Datei nicht alle Tabellen der Datenbank enthält. Wenn eine Tabelle sie referenzierende Fremdschlüssel hat, kann die Datenbank nicht ohne den Inhalt der Tabelle neu aufgebaut werden.

Es wird empfohlen, dass Sie die Option -e mit der Option -d nur verwenden, um Daten aus allen Tabellen außer jenen durch -e festgelegten Tabellen zu entladen.

Verschlüsselungsalgorithmus für die Datenbank- oder Tabellenverschlüsselung an geben (-et). Geben Sie -ea simple für die einfache Verschlüsselung an (nicht -ek oder -ep). Eine einfache Verschlüsselung ist gleichbedeutend mit der Verschleierung und und dient nur dazu, die Daten bei einem zufälligen Direktzugriff auf die Datenbankdatei zu verbergen, wobei das Entschlüsseln der Daten in Ihrer Datenbank mithilfe eines Festplatten-Dienstprogramms erschwert wird.

Um die Sicherheit zu erhöhen, geben Sie AES oder AES256 für starke 128-Bit- bzw. 256-Bit-Verschlüsselung an. Geben Sie AES_FIPS oder AES256_FIPS für FIPS-bestätigte 128-Bit- bzw. 256-Bit-Verschlüsselung an. Bei starker Verschlüsselung müssen Sie auch die Option -ek oder -ep angeben. Weitere Hinweise zur starken Verschlüsselung finden Sie unter Starke Verschlüsselung.

Um eine nicht verschlüsselte Datenbank zu erstellen, geben Sie die Option -ea none an oder geben die Option -ea nicht an (und geben weder -e, -et, -ep noch -ek an).

Wenn Sie die Option -ea nicht angeben, ist das Standardverhalten wie folgt:

• -ea none, wenn -ek, -ep oder -et nicht angegeben ist
• -ea AES, wenn -ek oder -ep angegeben ist (mit oder ohne -et)
• -ea simple, wenn -et ohne -ek oder -ep verwendet wird

Algorithmusnamen berücksichtigen die Groß- und Kleinschreibung nicht.

Einen Chiffrierschlüssel im cbunload-Befehl für die neu erstellte Datenbank angeben, wenn Sie eine Datenbank entladen und erneut laden (unter Verwendung der Option -an). Wenn Sie eine stark verschlüsselte Datenbank erstellen, müssen Sie den Chiffrierschlüssel liefern, um die Datenbank oder das Transaktionslog überhaupt verwenden zu können. Der für die Verschlüsselung verwendet Algorithmus ist der, den Sie mit der Option -ea angeben. Wenn Sie die Option -ek angeben, ohne -ea anzugeben, wird der AES-Algorithmus verwendet. Weitere Hinweise finden Sie unter Starke Verschlüsselung.

Achten Sie auf Ihren Schlüssel. Hinterlegen Sie eine Kopie Ihres Schlüssels an einem sicheren Ort. Ein verlorener Schlüssel führt zu einer nicht benutzbaren Datenbank, die sich nicht wiederherstellen lässt.

Aufforderung zur Angabe eines Chiffrierschlüssels für die neu erstellte Datenbank, wenn Sie Ihre Datenbank entladen und erneut unter Verwendung der Option -an laden. Diese zusätzliche Sicherheitsmaßnahme verhindert, dass der Chiffrierschlüssel in lesbarer Form angezeigt wird. Wenn Sie die Option -ep ohne -an angeben, wird die -ep ignoriert. Wenn Sie die Optionen -ep und -an angeben, müssen Sie den Chiffrierschlüssel zur Bestätigung der Eingabe ein zweites Mal eingeben. Wenn die Eingaben nicht übereinstimmen, schlägt das Entladen fehl. Weitere Hinweise finden Sie unter Starke Verschlüsselung.

Verschlüsselung aus verschlüsselten Tabellen während eines Entladevorgangs entfernen.

Beim Neuaufbau einer Datenbank mit aktivierter Tabellenverschlüsselung müssen Sie entweder -er oder -et angeben, um anzuzeigen, ob bei der neuen Datenbank die Tabellenverschlüsselung aktiviert ist. Sonst erhalten Sie einen Fehler, wenn Sie versuchen, Daten in die neue Datenbank zu laden.

Der folgende Befehl entlädt eine Datenbank (mydata.db) mit verschlüsselten Tabellen in eine neue Datenbank (mydatacopy.db), bei der die Tabellenverschlüsselung nicht aktiviert ist, wobei die Verschlüsselung von verschlüsselten Tabellen entfernt wird:

dbunload -an c:\mydatacopy.db -er 
         -c "UID=DBA;PWD=sql;
         DBF=c:\mydata.db;
         DBKEY=29bN8cj1z"

Datenbanktabellen-Verschlüsselung in der neuen Datenbank aktivieren (-an oder -ar muss auch angegeben sein). Wenn Sie die Option -et ohne die Option -ea angeben, wird der AES-Algorithmus verwendet. Wenn Sie die Option -et angeben, müssen Sie auch die Optionen -ep oder -ek angeben. Sie können die Tabellenverschlüsselungs-Einstellungen für die neue Datenbank ändern, sodass sie sich von den Einstellungen der entladenen Datenbank unterscheiden.

Beim Neuaufbau einer Datenbank mit aktivierter Tabellenverschlüsselung müssen Sie entweder -er oder -et angeben, um anzuzeigen, ob bei der neuen Datenbank die Tabellenverschlüsselung aktiviert ist. Sonst erhalten Sie einen Fehler, wenn Sie versuchen, Daten in die neue Datenbank zu laden.

Das folgende Beispiel entlädt eine Datenbank (mydata.db), die Tabellen hat, die mit dem Algorithmus für einfache Verschlüsselung chiffriert sind, in eine neue Datenbank (mydatacopy.db), bei der die Tabellenverschüsselung aktiviert ist, und verwendet AES_FIPS-Verschlüsselung mit dem Schlüssel 34jh:

dbunload -an c:\mydatacopy.db -et -ea AES_FIPS
         -ek 34jh
         -c "UID=DBA;PWD=sql;DBF=c:\mydata.db"

Materialisierte Ansichten   Standardmäßig werden als MANUAL REFRESH definierte materialisierte Ansichten nach einem Neuladen nicht initialisiert. Wenn Sie festlegen wollen, dass diese materialisierten Ansichten im Zuge des Neuladeverfahrens initialisiert werden, geben Sie die Option -g an. Wenn Sie -g angeben, führt der Datenbankserver die Systemprozedur sa_refresh_materialized_views aus. Weitere Hinweise finden Sie unter sa_refresh_materialized_views-Systemprozedur.

Bei der Verwendung der Option -g sollten Sie bedenken, dass die Initialisierung aller materialisierten Ansichten dazu führen kann, dass der Neuladeprozess signifikant länger dauert. Andererseits bewirkt ein Weglassen der Option -g, dass die erste Abfrage, die eine nicht-initialisierte Ansicht zu verwenden versucht, warten muss, während der Datenbankserver die Ansicht initialisiert, wodurch unerwartete Verzögerungen bewirkt werden können. Wenn Sie die Option -g nicht verwenden, können Sie die materialisierten Ansichten auch manuell initialisieren, nachdem das Neuladen abgeschlossen ist. Weitere Hinweise finden Sie unter Materialisierte Ansichten initialisieren.

Textindizes   Standardmäßig werden als MANUAL REFRESH definierte Textindizes nach einem Neuladen nicht initialisiert. Wenn Sie definieren möchten, dass Textindizes im Zuge des Neuladeverfahrens initialisiert werden, geben Sie die Option -g an. Wenn Sie -g angeben, führt der Datenbankserver die Systemprozedur sa_refresh_text_indexes aus. Weitere Hinweise finden Sie unter sa_refresh_text_indexes-Systemprozedur.

Daten in die sa_diagnostic_auxiliary_catalog-Tabelle einfügen. Diese Tabelle ordnet Objekt-IDs für Tabellen, Benutzer, Prozeduren usw. aus der Quelldatenbank der Protokollierungsdatenbank zu. Es werden auch alle Histogramme entladen/neugeladen. Diese Option wird bei der Erstellung einer Protokollierungsdatenbank verwendet, d.h. eine Datenbank, die Diagnoseprotokollierungsinformationen erhält. Die Tabelle sa_diagnostic_auxiliary_catalog ermöglicht es dem Server, Bedingungen zu simulieren, die vorherrschten, als Protokollierungsdaten aufgezeichnet wurden (z.B. für die Verwendung mit dem Indexberater oder bei einer Anwendungsprofilerstellung). Diese Option ist besonders zusammen mit der Option -n nützlich. Weitere Hinweise finden Sie unter Erweiterte Anwendungsprofilerstellung mithilfe der Diagnoseprotokollierung und sa_diagnostic_auxiliary_catalog-Tabelle.

Erzwingen, dass der aktuelle Wert von SYSTABCOL.max_identity bei einem Wiederaufbau der Datenbank erhalten bleibt.

Standardmäßig gilt: Wenn eine Datenbank mit Tabellen, die Autoinkrementspalten enthalten, neu aufgebaut wird, berechnet der Datenbankserver den nächsten verfügbaren Wert für jede Autoinkrementspalte basierend auf den aktuellen Inhalten der Tabellen. In den meisten Fällen ist dies ausreichend. Wenn allerdings Zeilen am Ende des Wertebereichs gelöscht wurden, können Werte wieder verwendet werden, was in bestimmten Fällen nicht wünschenswert ist.

Wenn Sie die Option -l angeben, werden Aufrufe der Systemprozedur sa_reset_identity in das generierte reload.sql-Skript für jede Tabelle eingefügt, die einen Autoinkrementwert enthält, sodass der Wert von SYSTABCOL.max_identity erhalten bleibt.

Siehe auch:

• Tabellen mit Autoinkrement-Spalten neu laden
• SYSTABCOL-Systemansicht
• sa_reset_identity-Systemprozedur

Datenbankobjekte nach Namen geordnet entladen. Standardmäßig generiert dbunload Objekte in der Reihenfolge, in der sie erstellt wurden. Wenn Sie die -no-Option eingeben, können Sie Datenbankschemas vergleichen, wenn die Datenbanken dieselben Objekte enthalten, die aber zu unterschiedlichen Zeitpunkten erstellt wurden.

Die Objektdefinitionen sind nach Objekttypen in alphabetischer Reihenfolge in der reload.sql-Datei geordnet, wenn -no angegeben wird:

• Benutzer
• Gruppenmitgliedschaften
• Tabellen
• Indizes und Fremdschlüssel
• Ansichten
• Prozeduren
• Funktionen
• Trigger
• Ereignisse
• Webdienste

Die Objektdefinitionen werden in der Reihenfolge Eigentümer,Name ausgegeben. In einigen Fällen wird ein drittes Element in die Reihenfolge aufgenommen (zum Beispiel: Fremdschlüssel-Rollenname, Triggername).

Die Option -no kann mit den Optionen -n, -nl, -ar, -an oder -ac nicht verwendet werden. Zur Vereinfachung von Vergleichen wird empfohlen, dass Sie die Option -no verwenden, wenn Sie die Reload-Skripten für Datenbanken vergleichen, die mit derselben Version des Datenbankservers erstellt wurden, da es bei den Objektdefinitionen kleinere Unterschiede geben kann.

Eine Liste von Tabellen zum Entladen angeben. Standardmäßig werden alle Tabellen entladen. Zusammen mit der Option -n haben Sie die Möglichkeit, nur eine Gruppe von Tabellendefinitionen zu entladen. Tabellennamen berücksichtigen nie die Groß- und Kleinschreibung, auch in Datenbanken, die die Groß- und Kleinschreibung berücksichtigen.

Eine Datei reload.sql, die mit der Option -t erstellt wurde, darf nicht benutzt werden, um eine Datenbank neu zu erstellen, weil die Datei nicht alle Tabellen der Datenbank enthält. Wenn eine Tabelle sie referenzierende Fremdschlüssel hat, kann die Datenbank nicht ohne den Inhalt der Tabelle neu aufgebaut werden.

Es wird empfohlen, dass Sie die Option -t mit der Option -d nur verwenden, um Daten aus den durch "-t" festgelegten Tabellen zu entladen.

Bestehende Befehlsdateien ersetzen, ohne zur Bestätigung aufzufordern. Wenn Sie die Option -q angeben, müssen Sie auch -y angeben, sonst schlägt das Entladen fehl, wenn dbunload erkannt, dass eine Befehlsdatei bereits existiert.

Beim Entladen von Datenbanken, die in ein Replikationssystem eingebunden sind, gibt es besondere Punkte zu beachten. Weitere Hinweise finden Sie unter Entfernte Datenbanken extrahieren und Upgrade von SQL Remote.