gbak - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

gbak — Firebird-Datenbank sichern/wiederherstellen

ZUSAMMENFASSUNG

gbak -b [Backup-Option ...] [Allgemeine Option ...] Quelle Ziel

gbak -c|-r [Wiederherstellungsoption ...] [Allgemeine Option ...] Quelle Ziel

BESCHREIBUNG

gbak ist das Tool zum Verwalten der Sicherung und Wiederherstellung von Firebird-Datenbanken.

Im Backup-Modus Quelle ein vorhandener Datenbankpfad ist (kann den Servernamen enthalten) und Ziel is
Name der Sicherungsdatei. Es könnte auch ein spezieller Gerätename wie /dev/stdout sein (um umzuleiten
Backup-Daten auf STDOUT) oder /dev/st, um das Backup auf Band zu speichern.

Im Wiederherstellungsmodus Quelle ist eine vorhandene Sicherungsdatei (oder ein spezielles Gerät wie /dev/stdin für
STDIN oder /dev/st, um das Backup vom Band zu erhalten) und Ziel ist der Pfad zur Firebird-Datenbank und
kann den Servernamen enthalten.

Alle Optionen können abgekürzt werden. Unten beide Vollversionen der Optionen und die kürzeste
mögliche Versionen angegeben.

COMMON OPTIONAL

-Benutzer Benutzername
Benutzername, der beim Herstellen einer Verbindung mit der Datenbank verwendet werden soll. Überschreibt die Umgebungsvariable. Sehen
.

-Rolle] Rollenname
SQL-Rolle, die beim Herstellen einer Verbindung mit der Datenbank verwendet werden soll. Überschreibt die Umgebungsvariable. Sehen
.

-Passwort] Passwort
Kennwort für die Verbindung mit der Datenbank. Überschreibt die Umgebungsvariable. Sehen
.

-Service]
Verwenden Sie den Dienste-Manager, wenn Sie mit einer Datenbank kommunizieren.

-verifizieren]
Melden Sie jede Aktion.

Zeigt ausführliche Informationen darüber an, welche Metadaten verarbeitet werden, welche Tabelle verwendet wird
gesichert/wiederhergestellt werden und wie viele Datensätze verarbeitet werden.

-y Weg
Leiten Sie Status-/Fehlermeldungen an den angegebenen Pfad um.

-z
Melden Sie die vollständige Versionsnummer, bevor Sie etwas anderes tun.

BACKUP OPTIONAL

-Backup-Datenbank]
Aktivieren Sie den Backup-Modus.

-Konvertieren]
Konvertieren Sie externe Tabellen in Tabellen.

Normalerweise werden externe Tabellen während der Sicherung und Wiederherstellung ignoriert. Mit -Konvertieren zu erhalten
externe Tabellen werden wie jede andere reguläre Tabelle in die Sicherung eingeschlossen. Wenn ein solches Backup
wiederhergestellt wird, werden diese zuvor externen Tabellen als reguläre Tabellen angelegt.

-Faktor] num
Blockierender Faktor. Ausgabe wird in Block von geschrieben num Bytes. Nützlich beim Sichern auf a
Band.

-g[arbage_collect]
Verhindern Sie die Müllabfuhr.

Normalerweise führt Firebird beim Durchlesen der Tabellen einen Garbage Collector aus. Seit der
Der Backup-Prozess liest alle Tabellen, dies erzwingt die Garbage Collection der gesamten Datenbank.
Falls Sie das Backup nur erstellen, um es über die vorhandene Datenbank wiederherzustellen, ist dieser Müll
Sammlung ist unnötig. Ein weiterer Grund, diese Optionen zu verwenden, ist, wenn eine Garbage Collection
auf andere Weise aktiviert wird - entweder mit gfix oder dem automatischen Sweep. Verwenden dieses Schalters
beschleunigt den Backup-Prozess und kann auch in einigen Fällen von beschädigten Backups helfen
Datenbanken.

-ignorieren]
Ignorieren Sie Datensätze mit ungültigen Prüfsummen.

Diese Option sollte nur beim Sichern beschädigter Datenbanken verwendet werden.

-Limbo]
Ignorieren Sie Transaktionen in der Schwebe.

Dieser Schalter bewirkt, dass der Backup-Prozess Transaktionen im Schwebezustand ignoriert.

-m[etadata_only]
Nur Metadaten sichern.

Bei dieser Option werden nur die Metadaten in das Backup geschrieben. Dies beinhaltet alles
Tabellen/Ansichten/Trigger/Indizes/gespeicherte Prozeduren/Domänen/Generatoren usw. Es sind keine Tabellendaten vorhanden
im Backup enthalten. Eine solche Sicherung ist nützlich, um eine "leere" Kopie einer Datenbank zu erstellen.

-nt
Verwenden Sie ein nicht übertragbares Backup-Format.

Standardmäßig wird ein "transportables" Backup-Format verwendet. Dies bedeutet, dass Sie eine Datenbank sichern können
auf Little-Endian-Rechnern und Wiederherstellen auf Big-Endian-Rechnern und umgekehrt. Durch die Nutzung -nt
das Backup ist nur auf Maschinen mit der gleichen "Endianness" sinnvoll.

-ol[d_descriptions]
Metadatenbeschreibungen im alten Stil speichern

WIEDERHERSTELLEN OPTIONAL

-Datenbank erstellen]
Aktivieren Sie den Wiederherstellungsmodus.

Ziel Datenbank wird erstellt und darf noch nicht vorhanden sein.

-r[ecreate_database] [überschreiben]]
Like -Datenbank erstellen, aber durch Hinzufügen überschreiben man kann den Austausch des Ziels erzwingen
Datenbank.

-rep[lace_database]
Like -Datenbank erstellen, aber das Ziel wird überschrieben, falls es existiert.

-puffer [Angebote] num
Ignorieren Sie beim Erstellen der Zieldatenbank Informationen über Datenbankpuffer, die im
sichern und die angegebene Anzahl von Puffern verwenden.

-expandieren]
Normalerweise verwendet Firebird die RLE-Komprimierung für Strings, wenn sie auf der Festplatte gespeichert werden. Diese Option
schaltet diese Komprimierung aus.

-inaktiv]
Stellen Sie Indizes im inaktiven Zustand wieder her. Dies kann verwendet werden, um ein Backup wiederherzustellen, das Daten enthält
inkonsistent mit Fremdschlüssel-/eindeutigen Beschränkungen.

-töten]
Erstellen Sie beim Wiederherstellen keine Schatten.

Normalerweise werden während der Wiederherstellung Datenbankschatten erstellt. Diese Option verhindert dies.

-Modus] Zugang
Datenbank mit gegebenem wiederherstellen Zugang.

Gültige Werte für Zugang sind schreibgeschützt und lesen Schreiben. Standardmäßig wird die Datenbank wiederhergestellt
mit seinem ursprünglichen Zugriffsmodus.

-n[o_validität]
Datenbank ohne Gültigkeitseinschränkungen wiederherstellen. Dazu gehören Fremdschlüssel, eindeutige und
Einschränkungen prüfen. Nützlich für die Wiederherstellung einer Sicherung, die inkonsistente Daten enthält.

-eins nach dem anderen]
Bestätigen Sie die Wiederherstellung der Transaktion nach dem Wiederherstellen jeder Tabelle.

-Seitengröße] num
Überschreiben Sie die im Backup gespeicherte Seitengröße. Gültige Werte für num sind 1024, 2048, 4096, 8192,
16384 und 32768.

-use_[all_space]
Normalerweise reserviert Fireburd auf jeder Datenseite etwas Platz für die weitere Verwendung. Dies reserviert
Platz wird für neu eingefügte Daten und zum Aufbewahren älterer Versionen der Daten verwendet. Haben
der dafür reservierte Platz "nahe" der Daten beschleunigt Änderungen. Wenn die
Datenbank wird hauptsächlich für Lesevorgänge verwendet, wobei angegeben wird -use_all_space wird einige retten
Raum.

Diese Option ist besonders nützlich, wenn Sie eine schreibgeschützte Datenbank wiederherstellen, da schreibgeschützt
Datenbanken benötigen keinen zusätzlichen Speicherplatz für Back-Versionen.

-fix_fss_metadata charset
Versuchen Sie beim Wiederherstellen von Metadaten, falls es kein gültiges UTF8 ist, eine Konvertierung vom angegebenen
Zeichensatz. Nützlich, wenn Tabellenbeschreibungen in einigen nationalen Nicht-UTF8 . angegeben sind
Kodierung, die mit Firebird vor Version 2.5 möglich war

-fix_fss_data charset
Beim Wiederherstellen von Tabellendaten, falls eine mit UNICODE_FSS-Zeichensatz definierte Spalte
kein gültiges UTF8 enthält (was mit Versionen von Firebird vor 2.5 möglich war), versuchen Sie es
Konvertieren Sie die Daten aus dem angegebenen Zeichensatz.

WIEDERHERSTELLEN TO MEHRFACH-DATEI DATABASE

Zuvor konnte Firebird nicht mit 64-Bit-Dateizeigern arbeiten, was eine Einschränkung darstellte
Datenbanken auf (etwa) 2 GB Größe pro Datenbank.

Da 2 GB seit Jahren nicht viel Daten sind, gibt es einen Mechanismus zur Verbreitung der Datenbank
in mehrere Dateien. Auf diese Weise können Sie mehrere 2-GB-Dateien haben, die alle Ihre Daten enthalten.

Beim Wiederherstellen in eine Datenbank mit mehreren Dateien hat das Zielargument folgende Form: Datei_1 Seiten_1
Datei_2 Seiten_2 ... Datei_N-1 Seiten_N-1 Datei_N

. Seiten_n gibt höchstens an, wie viele Seiten eingefügt werden sollen Datei_n. Letzter in der Liste ist a
Dateiname ohne Seitenbegrenzung - enthält alle Seiten, die nicht hineinpassen Datei_N-1. Beachten Sie, dass
Seiten_n wird in Seiten gemessen, nicht in Bytes, daher hängt die maximal mögliche Anzahl von der Seite ab
Größe.

Stellen Sie sich vor, Sie haben ein Dateisystem (oder ein altes Betriebssystem), das nur 32-Bit-Dateizeiger unterstützt.
Um auf Nummer sicher zu gehen, entscheiden Sie sich, Ihre Datenbank auf 2 GB-Dateien aufzuteilen. Wenn die Seitengröße für die
Datenbank ist 8192, dann kann jede Datei bis zu 2*1024*1024*1024/8192 = 262144 Seiten haben.

HINWEIS
Beachten Sie, dass Firebird auf einem neueren Betriebssystem und Dateisystem 64-Bit-Dateizeiger-Rendering verwenden kann
Multi-Datei-Datenbanken unnötig.

Wie alle anderen Firebird-Dienstprogramme akzeptiert gbak die folgenden Umgebungsvariablen:

ISC_USER-Standardwert für -Benutzer zu erhalten

ISC_ROLE Standardwert für -Rolle zu erhalten

ISC_PASSWORT
Standardwert für -Passwort zu erhalten

Beispiele:

In allen Beispielen -Benutzer, -Rolle und -Passwort Optionen sind aus Gründen der Übersichtlichkeit weggelassen. In einem echten
Weltsituation sie (oder ihre entsprechenden Umgebungsvariablen) verwendet werden.

Beachten Sie, dass hier verwendete Dateinamenerweiterungen nur empfohlen werden. Verwenden einheitlicher Erweiterungen
Das Schema hilft, den Dateityp zu erraten, indem es nur die Erweiterung betrachtet.

Hier sind einige häufig verwendete Erweiterungen:

.fdb Firebird-Datenbank

.gdb Firebird-Datenbank, ältere Erweiterung aus der Zeit, als Firebird Interbase war.
gdb stammt eigentlich aus der Grotton-Datenbank, die nach der Firma benannt ist, die sie erstellt hat
die Software im Jahr 1984.

.fdb.2 Zweite Datei der Datenbank mit mehreren Dateien

.fdb.3 Dritte Datei der Datenbank mit mehreren Dateien

.fdb.N N-te Datei der Datenbank mit mehreren Dateien

.fbk Firebird-Sicherungsdatei

.gbk Legacy-Erweiterung für Backup-Datei

.fbk.gz Gzipped Backup-Datei

Sicherungskopie a Datenbank in a Druckluft Format:
gbak -b db-srv:/database.fdb /dev/stdout | gzip > /file.fbk.gz

Wiederherstellen a Datenbank in neu Dateiname:
zcat /file.fbk.gz | gbak -c /dev/stdin db-srv:/new-database.fdb

Verwenden Sie gbak online mit den onworks.net-Diensten