FirebirdSQL logo

Sperren der Datenbank und Sicherung selbst erstellen

Eine typische Reihenfolge, um eine eigene Sicherung durchzuführen, kann wie folgt aussehen:

  1. Sperren der Datenbank mit dem -L (Lock; Sperren) Schalter:

    nbackup [-U user -P password] -L database

  2. Kopieren/sichern/zippen Sie nun die Datenbank mit Ihren bevorzugten Sicherungstools. Die Erstellung einer einfachen Dateikopie ist ebenfalls möglich.

  3. Entsperren Sie die Datenbank mit -N (uNlock; entsperren):

    nbackup [-U user -P password] -N database

Die letzte Anweisung wird wiederum die Änderungen, die in die Deltadatei geschrieben wurden, mit der Hauptdatenbankdatei zusammenführen.

Die Sicherung beinhaltet die Daten, so wie diese zum Zeitpunkt der Sperre der Datenbank vorgefunden wurden, unabhängig davon, wie lange der Zustand der Sperre andauerte und wie lange Sie gewartet haben, bis die Sicherung tatsächlich durchgeführt wurde.

Anmerkungen:

  • Anstelle eines Datenbankdateinamens können Sie auch einen Alias angeben.

  • Die Parameter "-U" und "-P" können weggelassen werden, wenn die Envars ISC_USER und ISC_PASSWORD festgelegt sind, wenn Sie auf einem Posix-System als Root angemeldet sind oder wenn die vertrauenswürdige Authentifizierung unter Windows dies zulässt.Für weitere Informationen, siehe Anmerkungen unter Vollständige Sicherungen erstellen.

  • Ab Firebird 2.5 kann anstelle von -P password auch -FE filename verwendet werden.

  • Sowohl -L als auch -N erstellen reguläre Datenbankverbindungen. In Firebird 2.1 und höher ist es sinnvoll den Schalter -T hinzuzufügen (siehe Datenbanktrigger unterdrücken).

  • Wenn Sie eine Rohgerätedatenbank mit Firebird 2.1 oder höher sperren, kann die Option -S sehr hilfreich sein, siehe auch [nbackup-lock-unlock-rawdevices].

  • Sie können optional -Z hinzufügen, um Versionsinformationen in die erste Zeile der Ausgabe zu drucken.

Warning

Was für das Sichern/Wiederherstellen gilt, gilt auch für die Sperr-/Entsperrschalter: Verwenden Sie sie nicht für Datenbanken mit mehreren Dateien.Lassen Sie nbackup in Datenbanken mit mehreren Dateien überhaupt nicht los, bis sich die Dinge geändert haben!

Wiederherstellen eines Backups nach “nbackup -L”

Eine Kopie einer gesperrten Datenbank ist selbst ebenfalls eine gesperrte Datenbank. Sie können sie also nicht einfach zurückkopieren und verwenden.Wenn Ihre ursprüngliche Datenbank verloren geht oder beschädigt wird und die selbst erstellte Kopie wiederhergestellt werden muss (oder wenn Sie die Kopie auf einem anderen Computer installieren möchten), gehen Sie wie folgt vor:

  1. Kopieren/wiederherstellen/entpacken Sie die gesicherte Datenbankdatei mit Ihren dafür benötigten Werkzeugen.

  2. Entsperren Sie nun die Datenbank, allerdings nicht mit dem -N Schalter, sondern mit -F (fixup):

    nbackup -F database

    Auch hier können Sie optional einen Alias anstelle eines Dateinamens verwenden und -Z für Versionsinformationen hinzufügen.Andere Optionen machen keinen Sinn.

Warum existieren mit -N und -F zwei Entsperrschalter?

  • -N stellt sicher, dass irgendwelche Änderungen seit der Sperre mit -L, mit der Hauptdatenbankdatei zusammengeführt werden.Danach geht die Datenbank wieder in den normalen Lese/Schreib-Modus über und die temporäre Datei wird gelöscht.

  • -F ändert nur das Zustandsflag der selbst-wiederhergestellen Datenbank auf “normal”.

Somit verwenden Sie:

  • -N nachdem Sie eine eigene Kopie/Sicherung erstellt haben (um ein vorangegangenes -L wieder zurückzunehmen);

  • -F nachdem Sie eine eigene Sicherung wiederhergestellt haben.

Note

Es ist etwas unglücklich, dass der letzte Schalter mit -F für Fixup benannt wurde.Es wird in diesem Fall nichts hergerichtet/repariert, sondern es wird die Datenbank nur entsperrt.Andererseits führt der -N (uNlock) Schalter nicht nur ein Entsperren, sondern auch ein Fixup durch,nämlich die Integration der Änderungen von der Deltadatei in die Haupdatenbankdatei.Damit müssen wir leben.Eine Gedankenstütze: Sie können -F als nur kennzeichnen betrachten.

docnext count = 7

Internas

Note

Dieser Abschnitt enthält keine erforderlichen Kenntnisse, enthält jedoch einige zusätzliche Informationen, die Ihr Verständnis der verschiedenen Schalter vertiefen können.

nbackup [parameter] -L führt folgende Schritte durch:

  1. Datenbankverbindung aufbauen;

  2. Starten einer Transaktion

  3. Aufruf von ALTER DATABASE BEGIN BACKUP (diese Anweisung wurde im Abschnitt Weitere Informationen zu Sicherungen -B diskutiert);

  4. Die Transaktion committen;

  5. Datenbankverbindung trennen.

nbackup [parameter] -N folgt den gleichen Schritten, allerdings mit einem “…​ END BACKUP” in Schritt 3.

nbackup [parameter] -F führt folgende Schritte aus:

  1. Die wiederhergestellte Datenbankdatei wird geöffnet;

  2. In dieser Datei wird das Zustandsflag von gesperrt (nbak_state_stalled) auf normal (nbak_state_normal) geändert;

  3. Die Datei wird wieder geschlossen.

Note

nbackup -F arbeitet rein auf Dateiebene und kann daher auch ohne einen laufenden Firebird Server ausgeführt werden.Jeder -U oder -P Parameter, der zum Kommando hinzugefügt wird, wird vollständig ignoriert.

Sperren von Rohgerätedatenbanken

Wie unter [nbackup-backups-rawdevices] beschrieben, können Probleme auftreten, wenn ein Delta für eine Datenbank auf einem Rohgerät erstellt werden muss.In Firebird 2.1 und höher weigert sich nbackup daher, mit Rohgerätedatenbanken zu arbeiten, es sei denn, es wurde zuvor ein expliziter Speicherort für die Delta-Datei festgelegt.Informationen zum Verfahren finden Sie unter [nbackup-deltafile] etwas weiter unten.

Es gibt noch ein weiteres Problem, wenn Sie ein Rohgerät sperren und kopieren: Sie kennen die tatsächliche Größe der Datenbank nicht!Das Rohgerät kann 10 GB groß sein, aber die Datenbank belegt möglicherweise nur 200 MB dieses Speicherplatzes.Um zu vermeiden, dass das gesamte Gerät kopiert werden muss, um auf der sicheren Seite zu sein — was möglicherweise viel Zeit und Platz verschwendet --, hat Firebird 2.1 einen neuen Parameter für nbackup eingeführt: -S.Dieser Parameter ist nur in Kombination mit -L gültig. Wenn dieser vorhanden ist, schreibt nbackup die Datenbankgröße in Seiten nach dem Sperren der Datenbank in stdout.Da die Größe in Seiten angegeben ist, muss sie mit der Seitengröße der Datenbank multipliziert werden, um die tatsächliche Anzahl der zu kopierenden Bytes zu erhalten.Wenn Sie das Kopierdienstprogramm dd verwenden, können Sie die Seitengröße als (i)bs und die Ausgabe von nbackup -L -S als count angeben.

Sperren / Entsperren der Datenbank bei der Sicherung virtueller Maschinen

Die Verwendung von Sicherungswerkzeugen für virtuelle Maschinen ohne Vorbereitung der Datenbank für einen solchen Sicherungstyp kann zu einer beschädigten (d.h. nutzlosen) Sicherungskopie führen.

Der Firebird-Server verwendet intensiv seinen eigenen Cache im RAM, um den Betrieb zu beschleunigen, und implementiert komplexe Techniken, um die Datenbankkonsistenz zu jedem Zeitpunkt sicherzustellen.Backup-Tools für virtuelle Maschinen kennen den Cache von Firebird nicht und betrachten Datenbankdateien normalerweise nicht als Dateien mit wahlfreiem Zugriff.

Wenn die Sicherung der virtuellen Maschine abgeschlossen ist, hat die darin enthaltene Datenbankdatei den Status wie nach einem Hard-Reset der VM, und sehr oft ist eine solche Kopie nicht konsistent, also beschädigt.Die Wahrscheinlichkeit eines solchen Problems ist höher, wenn viele aktive Benutzer die Datenbank ändern oder wenn ein aktiver Sweep-Prozess läuft.

Solche inkonsistenten Sicherungen können in jeder virtualisierten Umgebung, einschließlich öffentlicher Clouds, auftreten.

Um eine gute Firebird-Datenbanksicherung mit dem VM-Sicherungstool zu erstellen, muss die Datenbankdatei vor der VM-Sicherung mit nbackup gesperrt und danach entsperrt werden.Normalerweise ermöglicht das VM-Sicherungstool die Ausführung benutzerdefinierter Skripts vor und nach der Sicherung, mit denen Sie Firebird-Datenbanken sperren / entsperren können.

Delta-Datei einstellen

Standardmäßig befindet sich die Delta-Datei im selben Verzeichnis wie die Datenbank selbst.Der Dateiname ist ebenfalls derselbe, jedoch mit .delta.Dies ist normalerweise kein Problem, aber manchmal ist es wünschenswert oder sogar notwendig, den Ort zu ändern, z.B. wenn die Datenbank auf einem Rohgerät gespeichert ist.Nbackup selbst hat keine Möglichkeit, den Speicherort festzulegen.Dies muss über SQL erfolgen.

Stellen Sie mit jedem Client eine Verbindung zur Datenbank her, über die Sie Ihre eigenen SQL-Anweisungen eingeben und den folgenden Befehl eingeben können:

alter database add difference file 'pfad-und-dateiname'

Die benutzerdefinierbare Spezifikation der Deltadatei wird in der Datenbank gespeichert.Diese ist in der Systemtabelle RDB$FILES hinterlegt.Um das Standardverhalten wiederherzustellen, führen Sie die folgende Anweisung aus:

alter database drop difference file

Sie können beim Erstellen einer neuen Datenbank auch einen benutzerdefinierten Delta-Speicherort angeben:

create database 'path-and-dbname' difference file 'path-and-deltaname'
Note

  • Falls Sie in der [ADD] DIFFERENCE FILE-Anweisung nur den Dateinamen angeben, dann ist es wahrscheinlich, dass sich die Deltadatei nicht in dem selben Verzeichnis wie die Datenbank befinden wird, sondern im aktuellen Verzeichnis aus Sicht des Servers.Unter Windows kann das zum Beispiel das Systemverzeichnis sein.Die gleiche Logik gilt auch für relative Pfadangaben.

  • Der gesamte Verzeichnispfad muss bereits vorhanden sein.Firebird versucht nicht, fehlende Verzeichnisse zu erstellen.

  • Falls Sie die Spezifikation der Deltadatei ändern möchten, dann müssen Sie zuerst die alte Spezifikation mit DROP entfernen und die Neue mit ADD hinzufügen.

Sicherungsverlauf

Die Firebird-Datenbank speichert einen Verlauf aller nbackup-Aktivitäten in der Systemtabelle RDB$BACKUP_HISTORY.Diese Informationen werden von nbackup selbst für die interne Verwaltung verwendet, können aber auch verwendet werden, um herauszufinden, wann die letzte Sicherung durchgeführt wurde, auf welcher Ebene und wie der Dateiname lautet.

Um beispielsweise die letzten 5 Sicherungen anzuzeigen, können Sie Folgendes verwenden:

SELECT RDB$BACKUP_ID, RDB$TIMESTAMP, RDB$BACKUP_LEVEL, RDB$GUID,
    RDB$SCN, RDB$FILE_NAME
FROM RDB$BACKUP_HISTORY
ORDER BY RDB$TIMESTAMP DESC
ROWS 5

Die Spalten in RDB$BACKUP_HISTORY sind:

Spalte Beschreibung

RDB$BACKUP_ID

Primärschlüssel

RDB$TIMESTAMP

Uhrzeit und Datum der Sicherung

RDB$BACKUP_LEVEL

Backup-Level

RDB$GUID

GUID der Sicherung (zum Überprüfen der Abhängigkeiten zwischen Dateien)

RDB$SCN

Höchste Seitenmarkierung in der Sicherung

RDB$FILE_NAME

Dateiname der Sicherung

Eine Erläuterung des Feldes RDB$SCN finden Sie im Abschnitt [nbackup-background].

Der Inhalt der Tabelle RDB$BACKUP_HISTORY wird von gbak nicht gesichert und wiederhergestellt.Weitere Informationen finden Sie im Abschnitt [nbackup-background].

Technische Hintergrundinformationen

Nbackup führt eine physische Sicherung der Datenbankseiten durch, indem Seiten kopiert werden, die seit der letzten Sicherung der unmittelbar vorhergehenden Ebene geändert wurden.Eine Sicherung der Stufe 0 kopiert alle Seiten, während eine Sicherung der Stufe 1 nur die Seiten kopiert, die nach der letzten Stufe 0 geändert wurden.Um die geänderten Seiten finden zu können, verwendet Firebird eine Markierung, die als SCN (kurz für Seiten-Scan) bezeichnet wird.Diese Zahl wird bei jeder Änderung des Sicherungsstatus erhöht.Für jede Sicherung mit nbackup gibt es drei Statusänderungen:

  1. nbak_state_normal (kein Backup) zu nbak_state_stalled (Datenbank schreibt in Delta-Datei)

  2. nbak_state_stalled zu nbak_state_merge (Zusammenführen der Delta-Datei zurück in die Datenbank)

  3. nbak_state_merge zu nbak_state_normal (kein Backup)

Note

Diese drei Statusänderungen treten auch dann auf, wenn die Sicherung fehlschlägt.

Der SCN der Datenbank vor dem Start der Sicherung wird zusammen mit der Sicherung aufgezeichnet.Das allererste Backup erhält SCN 0, das zweite 3 usw.Diese Nummer ist unabhängig von der Sicherungsstufe.Der SCN wird verwendet, um die Seiten einer Datenbank zu markieren.Also zum Beispiel:

SCN Bedeutung

0

Seiten vor einer Sicherung

1

Seiten, die während der Sicherung in die Delta-Datei geschrieben/aktualisiert wurden

2

Seiten, die während des Zusammenführens der Delta-Datei in die Hauptsicherung geschrieben/aktualisiert wurden

3

Seiten, die nach Beendigung der ersten Sicherung + Zusammenführung geschrieben/aktualisiert wurden

Wenn eine Sicherung der Stufe 1 durchgeführt wird, sucht nbackup nach der Sicherung der letzten Stufe 0 und sichert alle Seiten mit einem SCN,der höher ist als der SCN dieser Sicherung der Stufe 0 (und so weiter).

Eine Sicherung und Wiederherstellung mit gbak stellt den Inhalt der Tabelle RDB$BACKUP_HISTORY nicht wieder her und setzt den SCN aller Seiten auf 0 zurück.Der Grund dafür ist, dass gbak anstelle einer physischen Sicherung eine logische Sicherung erstellt.Eine Wiederherstellung mit gbak schreibt also die gesamte Datenbank neu (und kann sogar die Seitengröße ändern).Dies macht frühere Sicherungen mit nbackup als Ausgangspunkt für nachfolgende Sicherungen bedeutungslos: Sie müssen mit einer neuen Stufe 0 beginnen.

Dokumentenhistorie

Der genaue Dateiversionsverlauf wird im Firebird-Dokumentations-Git-Repository aufgezeichnet; siehe https://github.com/FirebirdSQL/firebird-documentation

Versionsgeschichte

0.1

21. Okt. 2005

PV

Erste Fassung.

1.0

1. Dez. 2006

PV

“Beta”-Referenz in der Versionsinfo zu Beginn entfernt.Warnung bzgl. der Angabe von Sicherungsdateinamen in Bezug auf die Verwendung mit nbackup -R geändert.“(oder wird)” im ersten Satz der Dokumentenhistorie entfernt.

In den Beispielen wurde C:\Datenbanken auf C:\Daten geändert, um Darstellungsprobleme im PDF Dokument mit der Hintergrundfarbe zu vermeiden.

Abschnitt Setzen der Deltadatei hinzugefügt, und den Abschnitt Sollten Sie weiterlesen? entsprechend abgeändert.

1.0

4. Dez. 2006

TS

Deutsche Übersetzung basierend auf der englischen Dokumentenversion 1.0. Feedback für die Übersetzung von Frank Ingermann und Paul Vinkenoog.

1.1

5. Mai 2008

PV

Backups erstellen und wiederherstellen: Warnung vor Hochlastrisiken mit nbackup 2.0.0-2.0.3 hinzugefügt.

Vollständige Sicherung wiederherstellen: Die falsche Aussage, dass nbackup eine vorhandene Datenbank überschreibt, wenn keine aktiven Verbindungen vorhanden sind, wurde korrigiert.Der kursive Text über den Fehler bei der interaktiven Wiederherstellung wurde in einen Hinweis geändert und dessen Korrektur in 2.0.1 erwähnt.

Inkrementelle Sicherung: In 2.1 wurde eine Warnung eingefügt, dass inkrementelle Sicherungen fehlerhaft sind.

Datenbanktrigger unterdrücken (Firebird 2.1+): Neuer Abschnitt.

Sollten Sie weiterlesen?: Rechtschreibfehler beseitigt (engl. you → your).

1.2

19. Sep 2011

PV

Formatierung der Dokumentquelle: Geändert max. Zeilenlänge bis 100, ohne offene Zeilen.

Alle Abschnitte und Unterabschnitte haben jetzt eine ID.

Einleitung: Erster Satz bearbeitet.

Nbackup features — eine Übersicht {zwei Doppelpunkte} Einschränkungen von nbackup: Das zuvor zuletzt aufgelistete Listenelement wurde bearbeitet, um den Services Manager zu erwähnen.Listenelement zum direkten Dateizugriff hinzugefügt.Letzten Absatz entfernt.

Funktionen und Parameter: Neuer Abschnitt.

Backups erstellen und wiederherstellen: Leicht veränderter letzter Satz des ersten Abs.Erweiterte Warnung: Informationen zur Rolle der direkten I/O mit großen Datenbanken unter Posix hinzugefügt.

Backups erstellen und wiederherstellen :: Vollständige Sicherungen :: Vollständige Sicherungen erstellen: Korrigiertes und erweitertes Listenelement für die Parameter -U und -P.Listenelemente für den Parameter -FE (neu in 2.5), den Parameter -T (neu in 2.1) und den Parameter -D (neu in 2.5, Backport auf 2.1.4) hinzugefügt.In Listenelementen, die mit “Die verschiedenen Parameter” beginnen, lautet der Text in Klammern jetzt (-B, -U usw.), da viele neue Parameter hinzugefügt wurden.

Backups erstellen und wiederherstellen :: Interna: Kleine Anpassung (engl. image → impression).

Backups erstellen und wiederherstellen :: Vollständige Sicherungen :: Wiederherstellen einer vollständigen Sicherung: Die Parameter -U und -P wurden aus der Spezifikation entfernt.Listenelement für Aliase hinzugefügt.Separater Hinweis zum fehlgeschlagenen interaktiven Wiederherstellen auf kursiven Text im Listenelement selbst geändert.Listenelement hinzugefügt, dass Server nicht ausgeführt werden muss und Anmeldeinformationen ignoriert werden müssen.

Backups erstellen und wiederherstellen :: Inkrementelle Backups: Bearbeitete Warnung: Fix in 2.1.1 erwähnt.

Backups erstellen und wiederherstellen :: Inkrementelle Backups :: Inkrementelle Sicherung wiederhergestellen: Die Parameter -U und -P wurden aus der formalen Syntax und dem 1. Listenelement entfernt.

Backups erstellen und wiederherstellen :: Sichern von Rohgerätedatenbanken: Neuer Abschnitt.

Backups erstellen und wiederherstellen :: Datenbanktrigger unterdrücken: Dieser Abschnitt wurde bearbeitet und erweitert, aber die Bemerkung “SYSDBA und nur Eigentümer” entfernt.

Backups erstellen und wiederherstellen :: Direkte I/O (Firebird 2.1.4+): Neuer Abschnitt

Backups erstellen und wiederherstellen :: Informationsoptionen (Firebird 2.5+): Neuer Abschnitt

Backups erstellen und wiederherstellen :: Sicherungen auf Remote-Servern (Firebird 2.5+): Neuer Abschnitt

Sperren und entsperren: Leicht veränderter letzter Satz des zweiten Abs.

Sperren und entsperren:: Sperren der Datenbank und Sicherung selbst erstellen: Kommentare hinzugefügt (Abs. + Auflistung).

Sperren und entsperren :: Wiederherstellen einer nach nbackup -L erstellten Sicherung: Informationen zur Verwendung von Alias und -Z wurden zu Schritt 2 der Prozedur hinzugefügt.Im nächsten Absatz übersetzt “en” (Rest aus dem niederländischen Original) → “und”.Hinweis zu Hinweis über das Lesen von -F als nur kennzeichnen hinzugefügt.

Sperren und entsperren :: Sperren von Rohgerätedatenbanken: Neuer Abschnitt.

Sperren und entsperren :: Interna: Bearbeiteter Hinweis.

Delta-Datei einstellen: 1. Absatz weitgehend umgeschrieben;bezieht sich jetzt auf Rohgerätedatenbanken.Letzten Satz in einen eigenen Absatz aufgeteilt.Informationen (Para + Programmliste) zum Setzen von Delta mit CREATE DATABASE hinzugefügt.1. Liste in Anmerkungen: ADD → [ADD].

Dokumenthistorie: Link auf CVS geändert (sowohl Text als auch URL);zeigt jetzt direkt auf das Dokument.

Lizenzhinweise: Ende des Jahres in Copyright Copyright jetzt 2011.

1.3

12. Okt. 2011

PV

Funktionen und Parameter: In der ersten Tabelle: selbst wiederhergestellt → vom Benutzer wiederhergestellt.In der zweiten Tabelle: Selbstwiederherstellung → Benutzerwiederherstellung.

Sperren und entsperren :: Sperren der Datenbank und Sicherung selbst erstellen: Abschnitt umbenannt Sperren der Datenbank und Sicherung selbst erstellen.

Sperren und entsperren :: Wiederherstellen einer nach nbackup -L erstellten Sicherung: 2. Liste in der 1. Auflistung: selbst wiederhergestellt → vom Benutzer wiederhergestellt.

1.4

18. Sep. 2014

MR

Sicherungsverlauf: Neuer Abschnitt

Technische Hintergrundinformationen Neuer Abschnitt

1.5

27. Jun. 2020

MR

Konvertierung in AsciiDoc, geringfügige Bearbeitung von Texten

1.5-de

01. Jul. 2020

MK

Deutsche Übersetzung basierend auf der englischen Dokumentenversion 1.5.

1.6

25. Jul. 2020

AK

Absatz über VM-Sicherungen, Beispiel mit nicht standardmäßigem Port, Absatz mit Leistungshinweisen zur inkrementellen Sicherung

1.6-de

25. Jul. 2020

MK

Ergänzungen von Alexey Kovyazin in deutsche Übersetzung implementiert. Dokumenttitel angepasst.