JetBackup-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

JetBackup-Funktion

Die JetBackup -Funktion erstellt eine Sicherungskopie der Datenbank, während die Datenbank online ist. Diese Funktion ist in erster Linie für Abwärtskompatibilität Kompatibilität mit Windows 2000 und früheren Datenbankmodule, nur eine Instanz einer Datenbank zulässig ist. In diesem Fall wird die aktive Instanz die Instanz, die gesichert werden.

JET_ERR JET_API JetBackup(
  __in          JET_PCSTR szBackupPath,
  __in          JET_GRBIT grbit,
  __in          JET_PFNSTATUS pfnStatus
);

Parameter

szBackupPath

Das Verzeichnis, in dem die Sicherung gespeichert ist. Der Sicherungspfad NULL ist, wird die Funktion die Protokolle möglichst abgeschnitten.

JET_errInvalidGrbit

Eine Gruppe von Bits 0 (null) oder mehrere der folgenden Optionen angeben.

pfnStatus

Zeiger auf die JET_PFNSTATUS Callback-Funktion, die Benachrichtigungsinformationen über den Fortschritt des Sicherungsvorgangs bereitstellt.

Return Value

Die Funktion gibt eine der JET_ERR Fehlercodes. Im folgenden werden die am häufigsten zurückgegeben. (Eine vollständige Liste der Fehler für diese API, finden Sie unter Fehlercodes von Extensible Storage Engine).

Wenn die Funktion erfolgreich ist, werden alle für die erforderlichen Dateien bis zu dem Zeitpunkt der Sicherung eine Wiederherstellung im Datensicherungsverzeichnis enthalten sein. Ist dies eine vollständige Sicherung, werden die Dateien der Datenbankdateien und die Protokolldateien erforderlich, um die Datenbank in einen konsistenten Status zu versetzen. Ist dies bei einer inkrementellen Sicherung, wird nur die Verzeichnisse, aber die bereits vorhandenen Dateien (Datenbanken und Protokolldateien) zusammen mit den neuen Protokolldateien Dateien hinzugefügt werden Protokolldateien werden wiederhergestellt werden, um die Datenbank wieder in den Zustand zurückzuversetzen, in dem gegenwärtig, die die Sicherung beginnt.

Als Seite Auswirkungen der Sicherung werden die Protokolldateien, die nicht mehr benötigt werden abgeschnitten.

In der gleichen Zeit werden die Kopfzeilen der Datenbank mit den Informationen aktualisiert werden, wenn die letzte Sicherung stattgefunden.

Wenn die Funktion fehlschlägt, werden es keine Dateien im Ziel-backup-Verzeichnis, sodass keine Wiederherstellung möglich. In der gleichen Zeit werden die aktuellen Protokolldateien nicht abgeschnitten.

Anmerkungen

Die verschiedenen Schritte der Sicherung müssen Ereignisprotokolleinträge generiert, einschließlich der Dateinamen, das Abschneiden der Protokolldateien und das letzte Ergebnis der Sicherung.

Inkrementelle Sicherungen sind möglich, nur nach eine vollständige Sicherung durchgeführt wurde. Darüber hinaus sind inkrementelle Sicherungen nur möglich, wenn die Umlaufprotokollierung deaktiviert ist. Es wird empfohlen, dass backup-Verzeichnis keine anderen als der bei der Sicherung verwendeten oder von einer vorherigen erfolgreichen Sicherung hinzugefügte Dateien enthalten soll.

Backup-Verzeichnis sollte vorhanden sein, es sei denn, der Parameter JET_paramCreatePathIfNotExist für die Instanz festgelegt ist. Informationen finden Sie unter System-Parameter.

Führen Sie die Sicherung wird eine Überprüfung Prüfsumme auf allen Datenbankseiten verwendete und beginnend mit Windows Server 2003 als auch die Protokolldateien. Dies ermöglicht schätzen Sie die Integrität der Datenbank selbst für Seiten, die während des normalen Betriebs nicht gelesen werden. Wenn solche Beschädigungen gefunden wird, schlägt die Sicherung fehl.

Während der Sicherung wird die aktuelle Protokolldatei beendet werden, und ein neues Protokoll generiert werden. Auf diese Weise können alle erforderlichen Protokolldateien Kopien, sein, da das aktuelle Protokoll nicht mehr verwendet werden kann.

Es wird dringend empfohlen, dass die Sicherung nicht für andere Zwecke als das Sichern und Wiederherstellen auf der Ebene der Engine verwendet werden. Dies minimiert die Wahrscheinlichkeit erhöht, dass Fehler während des Sicherungs- und Wiederherstellungsvorgängen.

Voraussetzungen

Siehe auch

Extensible Storage Engine Dateien
JET_ERR
JET_GRBIT
JET_INSTANCE
JET_PFNSTATUS
JetRestore
JetRestore2
JetRestoreInstance
JetStopService
Systemparameter