JetBackupInstance-Funktion

Gilt für: Windows | Windows Server

JetBackupInstance-Funktion

Die JetBackupInstance-Funktion führt eine Streamingsicherung einer Instanz, einschließlich aller angefügten Datenbanken, in ein Verzeichnis aus. Unter mehreren vom Modul unterstützten Sicherungsmethoden ist dies die einfachste und am stärksten gekapselte Funktion.

Windows XP: JetBackupInstance wurde in Windows XP eingeführt.

    JET_ERR JET_API JetBackupInstance(
      __in          JET_INSTANCE instance,
      __in          JET_PCSTR szBackupPath,
      __in          JET_GRBIT grbit,
      __in          JET_PFNSTATUS pfnStatus
    );

Parameter

instance

Die Instanz der zu sichernden Datenbank.

szBackupPath

Das Verzeichnis, in dem die Sicherung gespeichert wird. Wenn der Sicherungspfad Null ist, werden die Protokolle nach Möglichkeit gekürzt, um die Funktion zu verwenden.

grbit

Eine Gruppe von Bits, die keine oder mehr der folgenden Optionen angeben.

Wert	Bedeutung
JET_bitBackupAtomic	Erstellt eine vollständige Sicherung der gesamten Datenbank. Dies ermöglicht die Beibehaltung einer vorhandenen Sicherung im selben Verzeichnis für den Fall, dass die neue Sicherung fehlschlägt.
JET_bitBackupIncremental	Erstellt im Gegensatz zu einer vollständigen eine inkrementelle Sicherung. Dies bedeutet, dass nur die Protokolldateien gesichert werden, die seit der letzten vollständigen oder inkrementellen Sicherung erstellt wurden.
JET_bitBackupSnapshot	Für die zukünftige Verwendung reserviert.

pfnStatus

Zeigen Sie auf die JET_PFNSTATUS-Rückruffunktion, die Benachrichtigungsinformationen hinsichtlich des Fortschritts des Sicherungsvorgangs bereitstellt.

Rückgabewert

Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu möglichen ESE-Fehlern finden Sie unter Fehler beim Extensible Storage Engine und Fehlerbehandlungsparameter.

Rückgabecode	Beschreibung
JET_errSuccess	Der Vorgang wurde erfolgreich beendet.
JET_errBackupInProgress	Für dieselbe Instanz wird bereits eine Sicherung ausgeführt. Mehrere gleichzeitige Sicherungen sind nicht zulässig.
JET_errBackupNotAllowedYet	Die Instanz ist noch nicht für die Sicherung bereit, da sie initialisiert wird.
JET_errClientRequestToStopJetService	Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten für die Instanz, die der Sitzung zugeordnet ist, aufgrund eines Aufrufs der JetStopService-Funktion beendet wurden.
JET_errInstanceUnavailable	Der Vorgang kann nicht abgeschlossen werden, da die mit der Sitzung verknüpfte Instanz einen schwerwiegenden Fehler festgestellt hat, der erfordert, dass der Zugriff auf alle Daten widerrufen werden muss, um die Integrität dieser Daten zu schützen. Windows XP: Dieser Rückgabewert wurde in Windows XP eingeführt.
JET_errInvalidBackup	Eine inkrementelle Sicherung ist nicht zulässig, wenn die Umlaufprotokollierung aktiviert ist.
JET_errInvalidGrbit	Die angegebenen Optionen sind ungültig.
JET_errInvalidParameter	Ein ungültiger Parameter wurde an die API übergeben.
JET_errInvalidPath	Der Zielpfad ist nicht vorhanden.
JET_errLoggingDisabled	Die Instanz wird ohne Protokollierung ausgeführt. Sicherungen sind nicht zulässig.
JET_errLogReadVerifyFailure	In einer Protokolldatei ist ein Prüfsummenüberprüfungsfehler aufgetreten.
JET_errLogWriteFail	Die Protokollierung für die Instanz ist aufgrund eines unerwarteten Fehlers vorübergehend oder dauerhaft deaktiviert.
JET_errNotInitialized	Der Vorgang kann nicht abgeschlossen werden, da die der Sitzung zugeordnete Instanz noch nicht initialisiert wurde.
JET_errReadVerifyFailure	Auf einer Datenbankseite ist ein Prüfsummenüberprüfungsfehler aufgetreten.
JET_errRestoreInProgress	Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die Instanz ausgeführt wird, die der Sitzung zugeordnet ist.
JET_errSessionSharingViolation	Dieselbe Sitzung kann nicht gleichzeitig für mehrere Threads verwendet werden. Windows XP: Dieser Rückgabewert wurde in Windows XP eingeführt.
JET_errTermInProgress	Der Vorgang kann nicht abgeschlossen werden, da die der Sitzung zugeordnete Instanz heruntergefahren wird.

Nachdem die Funktion einen Erfolg meldet, sind im Sicherungsverzeichnis alle Dateien vorhanden, die für eine Wiederherstellung bis zum Moment der Sicherung erforderlich sind. Bei einer vollständigen Sicherung sind dies die Datenbank- und Protokolldateien, die erforderlich sind, um die Datenbank in einen konsistenten Zustand zu bringen. Bei einer inkrementellen Sicherung werden lediglich Protokolldateien zu den Verzeichnissen hinzugefügt. Die bereits vorhandenen Dateien (Datenbanken und Protokolldateien) können jedoch zusammen mit den neuen Protokolldateien wiederhergestellt und die Datenbank kann auf den Zustand zum Zeitpunkt der Sicherung zurückgesetzt werden.

Als Nebeneffekt der Sicherung werden die nicht mehr benötigten Protokolldateien entfernt.

Gleichzeitig werden die Datenbankheader mit der Information aktualisiert, wann die letzte Sicherung erfolgte.

Bei einem Fehler werden keine Dateien in das Sicherungsverzeichnisziel geschrieben, sodass Wiederherstellung nicht möglich ist. Die aktuellen Protokolldateien werden aber nicht entfernt.

Hinweise

Während der einzelnen Schritten im Rahmen der Sicherung werden Ereignisprotokolleinträge generiert. Sie enthalten unter anderem die Dateinamen, die Protokollkürzung und das Endergebnis der Sicherung.

Inkrementelle Sicherungen sind erst möglich, nachdem eine vollständige Sicherung erstellt wurde. Darüber hinaus sind inkrementelle Sicherungen nur möglich, wenn die Umlaufprotokollierung deaktiviert ist. Es wird empfohlen, im Sicherungsverzeichnis keine anderen Daten zu speichern als die an der Sicherung beteiligten oder die durch eine frühere erfolgreiche Sicherung hinzugefügten.

Wenn der Parameter JET_paramCreatePathIfNotExist für die Instanz nicht festgelegt ist, sollte ein Sicherungsverzeichnis vorhanden sein. Weitere Informationen finden Sie unter Systemparameter.

Die Sicherung führt Prüfsummenüberprüfungen auf allen verwendeten Datenbankseiten und ab Windows Server 2003 auch in den Protokolldateien durch. Dies bietet die Möglichkeit, die Integrität der Datenbank auch für Seiten abzuschätzen, die während des normalen Betriebs nicht gelesen werden. Wenn eine solche Beschädigung auftritt, schlägt die Sicherung fehl.

Während der Sicherung wird die aktuelle Protokolldatei abgeschlossen und eine neue Protokollgenerierung begonnen. Dies ermöglicht das Kopieren der erforderlichen Protokolldateien, da die am wenigsten benötigte nicht mehr verwendet wird.

Es wird dringend empfohlen, die Sicherung nicht für andere Zwecke als zur Sicherung und zur Wiederherstellung auf Engine-Ebene zu verwenden. Dadurch wird die Wahrscheinlichkeit von Fehlern während der Sicherungs- und Wiederherstellungsvorgänge minimiert.

Anforderungen

Anforderung	Wert
Client	Erfordert Windows Vista oder Windows XP.
Server	Erfordert Windows Server 2008 oder Windows Server 2003.
Übergeordnet	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.
Unicode	Implementiert als JetBackupInstanceW (Unicode) und JetBackupInstanceA (ANSI).

Weitere Informationen

JET_ERR
JET_GRBIT
JET_INSTANCE
JET_PFNSTATUS
JetRestore
JetRestore2
JetRestoreInstance
JetStopServiceInstance
Systemparameter