Allgemeine Optionen
Wenn Sie gbak
im Sicherungs- oder Wiederherstellungsmodus ausführen, gibt es eine Reihe von Optionen, die für beide Modi gelten.Diese sind:
-?
-
Dieser Schalter zeigt die Befehlszeilenoptionen und -schalter an.Es ersetzt die alte Methode, bei der Sie einen ungültigen Schalter angeben mussten (siehe
-help
unten), um die Liste der gültigen Schalter zu sehen.HINWEIS: Ab Firebird 2.5.
-FE[TCH_PASSWORD] <password file name> | stdin | /dev/tty
-
Dieser Schalter bewirkt, dass das Kennwort für den entsprechenden Benutzer aus einer Datei gelesen wird und nicht in der Befehlszeile angegeben wird.Der angegebene Dateiname steht nicht in Anführungszeichen und muss für den Benutzer lesbar sein, der
gbak
ausführt.Wenn der Dateiname alsstdin
angegeben ist, wird der Benutzer zur Eingabe eines Kennworts aufgefordert.Auf POSIX-Systemen führt der Dateiname/dev/tty
auch zu einer Aufforderung zur Eingabe des Kennworts.HINWEIS: Ab Firebird 2.5.
-M[ETA_DATA]
-
Dieser Schalter bewirkt, dass Ihre Daten ignoriert und nicht gesichert oder wiederhergestellt werden.Bei einer Sicherung werden nur die Datenbank-Metadaten gesichert.Bei dieser Verwendung einer Wiederherstellung werden keine Daten in der Speicherauszugsdatei wiederhergestellt.Dieser Schalter kann verwendet werden, wenn Datenbankklone erstellt werden, die nur die
Tabellen
,Indizes
usw., aber keine der Daten enthalten müssen. -PAS[SWORD] <Kennwort>
-
Liefert das Passwort für den oben angegebenen Benutzernamen.Dies muss nicht angegeben werden, wenn die Umgebungsvariable
ISC_PASSWORD
vorhanden ist und den richtigen Wert hat. -RO[LE] <SQL Rollenname>
-
Ermöglicht die Angabe der Rolle, die vom verbindenden Benutzer verwendet werden soll.Nicht sehr praktisch und wird in der Praxis normalerweise nicht verwendet.
-U[SER] <Benutzername>
-
Ermöglicht die Angabe des Benutzernamens des SYSDBA- oder Datenbankbesitzer-Benutzers, wenn die Datenbank gesichert werden soll, oder im Falle einer Wiederherstellung (mit dem angegebenen Schalter
-c[reate]
) kann ein beliebiger gültiger Benutzername angegeben werden.Dies muss nicht angegeben werden, wenn die UmgebungsvariableISC_USER
vorhanden ist und einen korrekten Wert für den Benutzernamen hat.Datenbanken können nur von SYSDBA oder dem Datenbankeigentümer gesichert werden.Eine Wiederherstellung kann auch von SYSDBA oder dem Datenbankeigentümer durchgeführt werden. Wenn jedoch der Schalter
-c(reate)
verwendet wird, kann jeder validierte Benutzername eine neue Datenbank aus einer Sicherungsdatei erstellen. -V[ERIFY]
-
Normalerweise arbeitet
gbak
leise, ohne dass Informationen auf das Display geschrieben werden.Dieser Schalter kehrt diese Situation um und bewirkt, dass viele Informationen angezeigt werden.Standardmäßig wird die Ausgabe auf dem Bildschirm angezeigt. Sie können die Ausgabe jedoch mit dem Schalter-y
in eine Protokolldatei umleiten. -Y <Dateiname> oder der Text "suppress"
-
Wird in Verbindung mit dem Schalter
-v[erify]
verwendet, um Statusmeldungen auf eine Datei oder ein Gerät anstatt auf den Bildschirm umzuleiten oder sie insgesamt zu unterdrücken.Wenn "-y suppress" verwendet wird, werden keine Informationen auf den Bildschirm geschrieben, unabhängig davon, ob
-v[erify]
angegeben ist.Wenn ein Dateiname angegeben wird und der Schalter
-v[erify]
angegeben wird, wird die Datei geschrieben, um Fortschritte, Fehler usw. aufzuzeichnen.WarningIn allen bekannten Dokumentationen zu diesem Schalter wird erwähnt, dass der Text
"suppress_output"
und nicht"suppress"
sein sollte.Dies ist ein Fehler in der Dokumentation, da der Quellcode fürgbak
zeigt, dass der Schalter"suppress"
sein muss.WarningDie Protokolldatei darf nicht vorhanden sein.In diesem Fall schlägt der Sicherungs- oder Wiederherstellungsvorgang fehl:
tux> rm employee.log tux> gbak -backup employee.fdb employee.fbk -y employee.log -v tux> ls -l employee.log -rw-r--r-- 1 firebird firebird 21610 2010-08-04 10:22 employee.log tux> gbak -backup employee.fdb employee.fbk -y employee.log -v gbak:cannot open status and error output file employee.log
-Z
-
Diese Option zeigt einige Informationen über die verwendete Version von
gbak
und optional eine Datenbank an.Führen Sie den Befehl wie folgt aus, um nur die Version vongbak
zu erhalten:tux> gbak -z gbak:gbak version LI-V2.5.0.26074 Firebird 2.5 gbak: ERROR:requires both input and output filenames gbak:Exiting before completion due to errors tux> echo $? 1
Dies zeigt die aktuelle Version von
gbak
an und wird nach dem Anzeigen einiger Fehlermeldungen mit einem Fehlercode von 1 beendet, wie oben durch den Befehlecho
gezeigt.Diese Methode versucht nicht, Datenbanken zu sichern, und erfordert nicht, dass ein Benutzername und ein Kennwort definiert oder angegeben werden.Wenn Sie die Versionsnummer des Dienstprogramms
gbak
sowie Details zur Datenbank anzeigen möchten, müssen Sie einen gültigen Datenbanknamen und Sicherungsdateiname wie folgt angeben:tux> gbak -z employee employee.fbk -user sysdba -password secret gbak:gbak version LI-V2.1.3.18185 Firebird 2.1 gbak: Version(s) for database employee Firebird/linux (access method),version LI-V2.1.3.18185 Firebird 2.1 Firebird/linux (remote server),version LI-V2.1.3.18185 Firebird 2.1/tcp (tux)/P11 Firebird/linux (remote interface), version LI-V2.1.3.18185 Firebird 2.1/tcp (tux)/P11 on disk structure version 11.1 tux> echo $? 0
Sie werden aus dem oben Gesagten feststellen, dass ein gültiger Benutzername und ein gültiges Kennwort in der Befehlszeile oder mithilfe der Umgebungsvariablen
ISC_USER
undISC_PASSWORD
definiert werden müssen.Diese Version des Befehls wird mit einem Fehlercode von Null beendet.WarningDiese Methode zum Aufrufen von
gbak
wird eine Sicherung der Datenbank erzeugen.Wenn Ihre Datenbank groß ist, kann dies einige Zeit dauern, und die angegebene Sicherungsdatei wird überschrieben, wenn sie bereits vorhanden ist.Also Vorsicht.HINWEIS: Die obige Ausgabe wurde leicht abgekürzt, damit sie der Seitenbreite für ein PDF entspricht.
-help
-
Die Hilfe ist eigentlich keine gültige Option, kann jedoch verwendet werden, um den folgenden Informationsbildschirm als Ausgabe von "gbak" in Firebird 2.0 anzuzeigen:
gbak: legale Schalter sind: -B[ACKUP_DATABASE] Sicherungsdatenbank in Datei -BU[FFERS] überschreibt standardmäßig Seitenpuffer -C[REATE_DATABASE] Datenbank aus Sicherungsdatei erstellen -CO[NVERT] sichert externe Dateien als Tabellen -E[XPAND] keine Datenkomprimierung -FA[CTOR] Blockierungsfaktor -G[ARBAGE_COLLECT] sperrt die Speicherbereinigung -I[NACTIVE] deaktiviert Indizes während der Wiederherstellung -IG[NORE] ignoriert schlechte Prüfsummen -K[ILL] wiederherstellen, ohne Schatten zu erzeugen -L[IMBO] ignoriert Transaktionen in der Schwebe -M[ETA_DATA] Backup-Metadaten -MO[DE] <access> "read_only" oder "read_write" Zugriff -N[O_VALIDITY] stellt die Gültigkeitsbedingungen der Datenbank nicht wieder her -NOD[BTRIGGERS] führt keine Datenbank-Trigger aus -NT Nicht transportierbares Sicherungsdateiformat -O[NE_AT_A_TIME] stellt jeweils eine Tabelle wieder her -OL[D_DESCRIPTIONS] speichert Metadatenbeschreibungen alten Stils -P[AGE_SIZE] überschreibt die Standardseitengröße -PAS[SWORD] Firebird-Passwort -R[ECREATE_DATABASE] [O[VERWRITE]] erstellen (ersetzen, wenn O[VERWRITE] verwendet wird) Datenbank aus Sicherungsdatei -REP[LACE_DATABASE] ersetzt Datenbank aus Sicherungsdatei -RO[LE] Firebird SQL-Rolle -SE[RVICE] verwendet den Service Manager -T[RANSPORTABLE] transportable Backup - Daten im XDR-Format -USE_[ALL_SPACE] reserviert keinen Speicherplatz für Datensatzversionen -USER Firebird Benutzername -V[ERIFY] meldet jede ergriffene Aktion -Y <Pfad> Ausgabe der Statusmeldung umleiten / unterdrücken -Z Versionsnummer drucken
NoteDie Erklärung des Schalters
-m[eta_data]
impliziert, dass er nur in einer Sicherungssituation nützlich ist.Dies ist nicht der Fall, da es auch für eine Wiederherstellung verwendet werden kann.Ab Firebird 2.5 gibt es einen neuen Schalter
-?
, um die Liste der gültigen Optionen anzuzeigen.Die Ausgabe hat ein etwas anderes Layout und einige neue Optionen wurden hinzugefügt:gbak:Gültige Schalter sind: -B(ACKUP_DATABASE) Datenbank in Datei sichern -C(REATE_DATABASE) Datenbank aus Sicherungsdatei erstellen (wiederherstellen) -R(ECREATE_DATABASE) [O(VERWRITE)] erstellen (oder ersetzen, wenn OVERWRITE verwendet wird) Datenbank aus Sicherungsdatei (wiederherstellen) -REP(LACE_DATABASE) Datenbank aus Sicherungsdatei ersetzen (wiederherstellen) gbak:Sicherungsoptionen sind: -CO(NVERT) Sichern Sie externe Dateien als Tabellen -E(XPAND) Keine Datenkompression -FA(CTOR) Sperrfaktor -G(ARBAGE_COLLECT) Garbage Collection sperren -IG(NORE) Ignoriere fehlerhafte Checksummen -L(IMBO) Ignoriere Transaktionen in Limbo-Umgebungen -NOD(BTRIGGERS) Keine Datenbanktrigger ausführen -NT Nicht-transportable Sicherungsdateien -OL(D_DESCRIPTIONS) Speichert Metadatenbeschreibungen im alten Stil -T(RANSPORTABLE) Transportables Backup -- Daten im XDR-Format gbak:Wiederherstellungsoptionen sind: -BU(FFERS) Standardeinstellung für Seitenpuffer -FIX_FSS_D(ATA) Behebt fehlerhafte UNICODE_FSS-Daten -FIX_FSS_M(ETADATA) Behebt fehlerhafte UNICODE_FSS-Metadaten -I(NACTIVE) Indizes während der Wiederherstellung deaktivieren -K(ILL) Wiederherstellen ohne Schatten zu erzeugen -MO(DE) <access> Zugriff "read_only" oder "read_write" -N(O_VALIDITY) Stellt die Gültigkeitsbedingungen der Datenbank nicht wieder her -O(NE_AT_A_TIME) Stellt jeweils eine Tabelle wieder her -P(AGE_SIZE) Überschreibt die Standard-Seitengröße -USE_(ALL_SPACE) Reserviert keinen Platz für Datensatzversionen gbak:Allgemeine Optionen sind: -FE(TCH_PASSWORD) Holt Kennwort aus Datei -M(ETA_DATA) Nur Metadaten sichern oder wiederherstellen -PAS(SWORD) Firebird-Kennwort -RO(LE) Firebird SQL-Rolle -SE(RVICE) Service-Manager verwenden -USER Firebird-Benutzername -V(ERIFY) Jede Aktion ausgeben -Y <path> Statusausgaben umleiten / unterdrücken -Z Versionsnummer ausgeben
Die oben gezeigten Klammern geben an, wie viel des Switch-Namens Sie verwenden müssen, um Mehrdeutigkeiten zu vermeiden.Sobald Sie das absolute Minimum angegeben haben — den Teil vor dem öffnenden '[' — können Sie so viel von dem verwenden, was folgt, wie Sie möchten.Um beispielsweise den Schalter
-b[ackup_database]
zu verwenden, müssen Sie in der Befehlszeile mindestens-b
angeben, aber alles zwischen-b
und-backup_database
wird akzeptiert.Wenn Sie den Schalter
-help
wie diesen oder einen anderen ungültigen Schalter verwenden, wirdgbak
unter Linux und Windows mit dem Fehlercode 1 beendet.