Sicherungsdienstprogramm (dbbackup)

dbbackup [ options ] target-directory

Option

Beschreibung

@data

Liest Optionen aus der angegebenen Umgebungsvariablen oder Konfigurationsdatei ein. Siehe Konfigurationsdateien.

Wenn Sie Kennwörter oder andere Informationen in der Konfigurationsdatei schützen möchten, können Sie das Dienstprogramm zum Verschleiern von Dateien auf die Konfigurationsdatei anwenden. Siehe Dienstprogramm zum Verschleiern von Dateien (dbfhide).

-aw[ - ]

Aktiviert die automatische Optimierung der Writer-Threads, sodass die Performance der Sicherung durch eine erhöhte Anzahl von Writer-Threads insgesamt verbessert werden kann. Das Angeben von -aw- deaktiviert die automatische Optimierung der Writer-Threads und verhindert, dass der Datenbankserver zusätzliche Writer-Threads erstellt. Die Optionen -aw und -aw- müssen mit der Option -s verwendet werden.

-b block-size

Gibt die maximale Blockgröße (in Anzahl von Seiten) an, die zur Übertragung von Seiten vom Datenbankserver an dbbackup verwendet wird. Das dbbackup-Dienstprogramm versucht, diese Anzahl von Seiten zuzuweisen. Wenn das fehlschlägt, vermindert es wiederholt diesen Wert um die Hälfte, bis die Zuweisung erfolgreich ist. Standardwert ist 128 Seiten.

-bc Kommentar

Erfasst einen Kommentar in der Sicherungsverlaufsdatei. Bei Archivsicherungen wird der Kommentar auch in der Archivdatei erfasst. Die Option -bc muss mit der Option -s verwendet werden.

-c "keyword=value; ..."

Legt Verbindungsparameter fest.

-d

Sichert nur die Hauptdatenbankdateien, ohne die Transaktionslogdatei (sofern vorhanden) zu sichern.

-h[ - ]

Aktiviert den Sicherungsverlauf, wodurch eine Zeile an die Datei backup.syb angehängt wird. Das Angeben von -h- deaktiviert den Sicherungsverlauf und verhindert Aktualisierungen der Datei backup.syb. Die Optionen -h und -h- müssen mit der Option -s verwendet werden.

-k checkpoint-log-copy-option

Gibt an, wie dbbackup die Datenbankdateien verarbeitet, bevor sie in das Zielverzeichnis geschrieben werden. Die Entscheidung, entweder Pre-Images während einer Sicherung anzuwenden oder das Checkpoint-Log als Teil der Sicherung zu kopieren, wirkt sich auf die Performance aus. Wenn die Option -s angegeben ist, um eine auf dem Server durchgeführte Sicherung durchzuführen, ist die Standardeinstellung für -k "auto". Anderenfalls ist die Standardeinstellung "copy.

auto Der Datenbankserver überprüft die Menge des verfügbaren Speicherplatzes auf dem Datenträger, der das Sicherungsverzeichnis enthält. Wenn zumindest doppelt so viel Speicherplatz wie die Größe der Datenbank zum Start der Sicherung verfügbar ist, wird die Sicherung durchgeführt, als ob "copy" angegeben wurde. Anderenfalls wird sie durchgeführt, als ob "nocopy" angegeben wurde. Diese Einstellung kann nur verwendet werden, wenn ebenfalls die Option -s angegeben ist.
copy Die Sicherung liest die Datenbankdateien, ohne Pre-Images bei geänderten Seiten anzuwenden. Das gesamte Checkpoint-Log und der System-DBSpace werden in das Sicherungsverzeichnis kopiert. Bein nächsten Start der Datenbank stellt der Datenbankserver die Datenbank in dem Status wieder her, in dem sie beim Checkpoint zum Start der Sicherung war.
Da keine Seiten-Pre-Images in die temporäre Datei geschrieben werden müssen, kann die Verwendung dieser Option zu einer besseren Sicherungsperformance führen und interne Server-Konfliktsituationen mit anderen Verbindungen vermindern, die während einer Sicherung betrieben werden. Da die Sicherungskopie der Datenbankdatei jedoch das Checkpoint-Log enthält, das Pre-Images von Seiten enthält, die seit dem Start der Sicherung geändert wurden, kann die Sicherungskopie der Datenbankdateien größer als die Datenbankdateien zum Zeitpunkt des Sicherungsstarts sein. Die Option copy sollte nur verwendet werden, wenn der Speicherplatz im Zielverzeichnis kein Problem darstellt.
nocopy Das Checkpoint-Log wird nicht als Teil der Sicherung kopiert. Diese Option bewirkt, dass Pre-Images von geänderten Dateien in der temporären Datei gespeichert werden, damit sie während des Sicherungsvorgangs angewendet werden können. Die Sicherungskopien der Datenbankdateien haben dieselbe Größe wie die Datenbank zum Zeitpunkt des Sicherungsstarts. Die Sicherungskopien können tatsächlich etwas kleiner sein, weil das Checkpoint-Log in der Kopie nicht enthalten ist. Diese Option führt zu kleineren gesicherten Datenbankdateien, aber die Sicherung braucht möglicherweise länger und kann die Performance von anderen Vorgängen im Datenbankserver beeinträchtigen. Sie ist in Situationen nützlich, bei denen der Speicherplatz auf dem Ziellaufwerk beschränkt ist.
recover Der Datenbankserver kopiert das Checkpoint-Log (wie bei der Option copy), wendet aber das Checkpoint-Log an der Datenbank an, wenn die Sicherung abgeschlossen ist. Dies stellt die gesicherten Datenbankdateien im selben Status (und derselben Größe) wieder her, in der sie beim Start des Sicherungsvorgangs waren. Diese Option kann nützlich sein, wenn der Speicherplatz auf dem Sicherungslaufwerk beschränkt ist (sie benötigt dieselbe Menge an Speicherplatz wie die copy-Option zum Sichern des Checkpoint-Logs, aber die resultierende Dateigröße ist kleiner). Diese Einstellung kann nur verwendet werden, wenn ebenfalls die Option -s angegeben ist.

-l filename

Damit kann ein Sekundärsystem rasch aktiviert werden, wenn ein Server ausfällt. Eine Live-Sicherung stoppt nicht. Sie läuft, solange der Server läuft. Sie läuft, bis der Primärserver nicht mehr verfügbar ist. Zu diesem Zeitpunkt wird sie beendet, die gesicherte Logdatei ist aber funktionsfähig und kann dazu verwendet werden, ein zweites System schnell zu starten. Siehe Unterschiede zwischen Live-Sicherungen und Transaktionslogspiegeldateien und Live-Sicherungen erstellen.

Wenn Sie die Option -l angeben, dürfen Sie nicht die Option -s verwenden, um auf dem Server eine Sicherungskopie durchzuführen.

-n

Ändert die Namenskonvention für die Sicherungs-Transaktionslogdatei in jjmmttxx.log, wobei xx aufeinanderfolgende Buchstaben von AA bis ZZ sind und jjmmtt den aktuellen Wert für Jahr, Monat und Tag darstellt. Diese Option wird mit -r verwendet.

Die Sicherungskopie der Transaktionslogdatei wird im Verzeichnis gespeichert, das in der Befehlszeile unter Verwendung der jjmmttxx.log-Namenskonvention festgelegt wurde. Dadurch können Sicherungen von mehreren Versionen der Transaktionslogdatei im gleichen Sicherungsverzeichnis aufbewahrt werden.

Sie können auch die Optionen -x und -n verwenden, um die Logkopie umzubenennen. Zum Beispiel:

dbbackup -c "UID=DBA;PWD=sql" -x -n mybackupdir

-o filename

Schreibt Ausgabemeldungen in die benannte Datei.

-p

Sendet formatierte Meldungen zum Verarbeitungsfortschritt vom Datenbankserver an den Client.

Die Option -p wird ignoriert, es sei denn die Option -s wird für eine serverseitige Sicherung verwendet.

Weitere Hinweise zu formatierten Meldungen zum Verarbeitungsfortschritt finden Sie unter progress_messages-Option.

-q

Unterdrückt die Ausgabe von Meldungen. Diese Option ist nur verfügbar, wenn Sie dieses Dienstprogramm über eine Eingabeaufforderung ausführen.

-r

Benennt das Transaktionslog um und startet ein neues Transaktionslog. Erzwingt einen Checkpoint und bewirkt die folgenden drei Schritte:

Die aktuell arbeitende Transaktionslogdatei wird kopiert und in dem in der Befehlszeile festgelegten Verzeichnis gespeichert.
Das aktuelle Transaktionslog bleibt in seinem aktuellen Verzeichnis, wird jedoch unter Verwendung des Formats jjmmttxx.log umbenannt, wobei xx aufeinanderfolgende Buchstaben von AA bis ZZ sind und jjmmtt den aktuellen Wert für Jahr, Monat und Tag darstellt. Diese Datei ist dann nicht mehr das aktuelle Transaktionslog.
Eine neue Transaktionslogdatei wird erstellt, die keine Transaktionen enthält. Sie wird nach der Datei benannt, die zuvor das aktuelle Transaktionslog war und dann vom Datenbankserver als aktuelles Transaktionslog verwendet wird.

-s

Erstellt eine Sicherungskopie auf dem Server mit der BACKUP DATABASE-Anweisung. Wenn Sie die Option -s angeben, darf die Option -l (zum Erstellen einer Live-Sicherung des Transaktionslogs) nicht benutzt werden. Die Verzeichnisangabe erfolgt ausgehend vom aktuellen Serververzeichnis, deshalb wird empfohlen, einen vollständigen Pfadnamen anzugeben. Außerdem muss der Server über Schreibberechtigung für das angegebene Verzeichnis verfügen. Wenn die Option -s angegeben wird, zeigt das Sicherungsdienstprogramm keine Fortschrittsanzeige an und fordert nicht zur Bestätigung auf, bevor vorhandene Dateien überschrieben werden. Wenn Sie vor dem Überschreiben vorhandener Dateien zur Bestätigung aufgefordert werden möchten, dürfen Sie weder -s noch -y angeben. Sie müssen -s angeben, wenn Sie die Wiederherstellungsoption -k angeben.

-t

Erstellt eine Sicherung, die als inkrementelle Sicherung verwendet werden kann, da das Transaktionslog auf die letzte gesicherte Kopie der Datenbankdatei(en) angewendet werden kann.

-wa

Wartet, bis die Transaktionen abgeschlossen sind, um das Transaktionslog umzubenennen oder zu kürzen. Die Option -wa muss mit der Option -s verwendet werden.

-wb

Verzögert die Sicherung der Datenbank, bis keine aktiven Transaktionen mehr vorhanden sind. Die Option -wb muss mit der Option -s verwendet werden.

-x

Sichert das vorhandene Transaktionslog, das ursprüngliche Transaktionslog wird gelöscht und ein neues wird gestartet. Verwenden Sie diese Option nicht, wenn Sie mit einer Datenbankspiegelung arbeiten. Siehe Verwaltung von Transaktionslogdateien in einem Datenbankspiegelungssystem.

-xo

Löscht das aktuelle Transaktionslog und startet ein neues. Dieser Vorgang führt keine Sicherung durch, da er ausschließlich bezweckt, in Nicht-Replikationsumgebungen Speicherplatz freizugeben. Verwenden Sie diese Option nicht, wenn Sie mit einer Datenbankspiegelung arbeiten. Siehe Verwaltung von Transaktionslogdateien in einem Datenbankspiegelungssystem.

Vorsicht

Wenn Sie diese Option verwenden, kann dies zu einer Datenbank führen, die nach einem Datenträgerfehler nicht wiederhergestellt werden kann. Verwenden Sie diese Option nur, wenn Datenverluste akzeptabel sind.

Verwenden Sie die Option -xo nicht bei Datenbanken, die repliziert oder synchronisiert werden. SQL Remote und MobiLink stützen sich auf die Informationen aus dem Transaktionslog.

-y

Erstellt das Sicherungsverzeichnis ohne Ihre Bestätigung oder ersetzt eine frühere Sicherungsdatei im Verzeichnis ohne Ihre Bestätigung. Wenn Sie vor dem Überschreiben vorhandener Dateien zur Bestätigung aufgefordert werden möchten, dürfen Sie weder -s noch -y angeben.

target-directory

Gibt das Verzeichnis an, in das die Sicherungsdateien kopiert werden. Wenn das Verzeichnis nicht existiert, wird es erstellt. Das übergeordnete Verzeichnis muss allerdings bereits bestehen. Standardmäßig erstellt das Sicherungsdienstprogramm eine clientseitige Sicherung der Datenbankdateien. Um eine Sicherung auf dem Server zu erstellen, verwenden Sie die Anweisung BACKUP DATABASE mit der Option -s.

Sie müssen das BACKUP DATABASE-Systemprivileg haben.

Das Sicherungsdienstprogramm stellt eine Sicherungskopie von allen Dateien einer einzelnen Datenbank her. Eine einfache Datenbank besteht aus zwei Dateien: der Haupt-Datenbankdatei und dem Transaktionslog. Kompliziertere Datenbanken können Tabellen in mehreren Dateien speichern, wobei jede Datei ein eigener DBSpace ist. Alle Sicherungsdateien heißen genauso wie die Datenbankdateien. Die vom Sicherungsdienstprogramm erstellte Sicherungskopie umfasst für jede gesicherte Datei eine separate Datei.

Weitere Hinweise zum Erstellen von Archivsicherungen (eine einzige Datei, die sowohl Datenbankdatei als auch Transaktionslog enthält) finden Sie unter Archivsicherungen.

Das Verwenden des Sicherungsdienstprogramms auf einer laufenden Datenbank entspricht dem Kopieren der Datenbankdateien, wenn die Datenbank nicht läuft. Sie können das Sicherungsdienstprogramm zum Sichern der Datenbank ausführen, während andere Anwendungen oder Benutzer sie verwenden.

Wenn keine der Optionen -d oder -t verwendet wird, werden alle Datenbankdateien gesichert.

Standardmäßig erstellt das Sicherungsdienstprogramm eine clientseitige Sicherung der Datenbankdateien. Um eine Sicherung auf dem Server zu erstellen, verwenden Sie die Anweisung BACKUP DATABASE mit der Option -s.

Weitere Hinweise zur Durchführung von serverseitigen Sicherungen finden Sie unter BACKUP-Anweisung.

Vorsicht

Sicherungskopien der Datenbank und des Transaktionslogs dürfen auf keinen Fall geändert werden. Wenn während der Sicherung keine Transaktionen aktiv waren oder Sie BACKUP DATABASE WITH CHECKPOINT LOG RECOVER oder WITH CHECKPOINT LOG NO COPY angegeben haben, können Sie die Validität der Sicherungsdatenbank im Schreibschutzmodus prüfen, oder indem Sie eine Kopie der Sicherungsdatenbank validieren.

Wenn jedoch Transaktionen aktiv waren oder Sie BACKUP DATABASE WITH CHECKPOINT LOG COPY angegeben haben, muss der Datenbankserver eine Wiederherstellung der Datenbank bei ihrem Start durchführen. Die Wiederherstellung ändert die Sicherungskopie, und das sollte vermieden werden.

Beendigungscodes sind 0 (Erfolg) oder eine von 0 verschiedene Zahl (Fehlschlag).

Weitere Informationen zu Beendigungscodes finden Sie unter Exit-Codes der Softwarekomponenten.

Der folgende Befehl sichert zum Beispiel die Beispieldatenbank, die auf dem Computer "sample_host" läuft, im Verzeichnis SQLAnybackup. Hierzu wird eine Verbindung als DBA-Benutzer hergestellt:

dbbackup -c "Host=sample_host;DBN=demo;UID=DBA;PWD=sql" SQLAnybackup