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 einem Verzeichnis aus. Da die Engine mehrere Sicherungsmethoden unterstützt, ist dies die einfachste und am häufigsten gekapselte Funktion.

Windows XP: JetBackupInstance wird 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

Instanz

Die Instanz der zu sichernde Datenbank.

szBackupPath

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

grbit

Eine Gruppe von Bits, die null oder mehr der folgenden Optionen angibt.

Wert

Bedeutung

JET_bitBackupAtomic

Erstellt eine vollständige Sicherung der Datenbank. Dies ermöglicht die Beibehaltung einer vorhandenen Sicherung im gleichen Verzeichnis, wenn bei der neuen Sicherung ein Fehler auftritt.

JET_bitBackupIncremental

Erstellt eine inkrementelle Sicherung im Gegensatz zu einer vollständigen 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

Zeiger auf die JET_PFNSTATUS Rückruffunktion, die Benachrichtigungsinformationen zum Fortschritt des Sicherungsvorgangs bereitstellt.

Rückgabewert

Diese Funktion gibt den JET_ERR Datentyp mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errBackupInProgress

Für dieselbe Instanz wird bereits eine Sicherung ausgeführt. Mehrere Sicherungen sind nicht gleichzeitig 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 in der Instanz, die der Sitzung zugeordnet ist, aufgrund eines Aufrufs von JetStopServiceInstancebeendet wurden.

JET_errInstanceUnavailable

Der Vorgang kann nicht abgeschlossen werden, da für die der Sitzung zugeordnete Instanz ein schwerwiegender Fehler aufgetreten ist, der erfordert, dass der Zugriff auf alle Daten widerrufen wird, um die Integrität dieser Daten zu schützen.

Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt.

JET_errInvalidBackup

Eine inkrementelle Sicherung ist nicht zulässig, wenn die zirkuläre Protokollierung eingeschaltet 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. Es ist keine Sicherung 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 temporär 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 für mehrere Threads gleichzeitig verwendet werden.

Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt.

JET_errTermInProgress

Der Vorgang kann nicht abgeschlossen werden, da die der Sitzung zugeordnete Instanz heruntergefahren wird.

Nachdem die Funktion erfolgreich zurückgegeben wurde, sind im Sicherungsverzeichnis alle Dateien vorhanden, die für eine Wiederherstellung bis zum Zeitpunkt der Sicherung erforderlich sind. Wenn es sich um eine vollständige Sicherung handelt, handelt es sich bei den Dateien um die Datenbankdateien und die Protokolldateien, die benötigt werden, um die Datenbank in einen konsistenten Zustand zu bringen. Wenn es sich um eine inkrementelle Sicherung handelt, werden den Verzeichnissen nur Protokolldateien hinzugefügt, aber die bereits vorhandenen Dateien (Datenbanken und Protokolldateien) zusammen mit den neuen Protokolldateien können wiederhergestellt werden und die Datenbank zum Zeitpunkt der Sicherung wieder in den Zustand versetzt werden.

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

Gleichzeitig werden die Datenbankheader mit den Informationen aktualisiert, als die letzte Sicherung durchgeführt wurde.

Bei einem Fehler sind keine Dateien im Sicherungsverzeichnisziel vorhanden, sodass keine Wiederherstellung möglich ist. Gleichzeitig werden die aktuellen Protokolldateien nicht abgeschnitten.

Bemerkungen

Für die verschiedenen Schritte der Sicherung werden Ereignisprotokolleinträge generiert, einschließlich der Dateinamen, der Protokollkürzung und des Endergebnisses der Sicherung.

Inkrementelle Sicherungen sind erst möglich, nachdem eine vollständige Sicherung erstellt wurde. Inkrementelle Sicherungen sind auch nur möglich, wenn die zirkuläre Protokollierung deaktiviert ist. Es wird empfohlen, dass das Sicherungsverzeichnis keine anderen Dateien als die dateien enthält, die an der Sicherung beteiligt sind oder von einer vorherigen erfolgreichen Sicherung hinzugefügt wurden.

Das Sicherungsverzeichnis sollte vorhanden sein, es sei denn, der Parameter JET_paramCreatePathIfNotExist ist für die Instanz festgelegt. Weitere Informationen finden Sie unter Systemparameter.

Die Sicherung führt die Prüfsummenüberprüfung 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 zu schä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 wir starten eine neue Protokollgenerierung. Dies ermöglicht das Kopieren der erforderlichen Protokolldateien, da die letzte benötigte Protokolldatei nicht mehr verwendet wird.

Es wird dringend empfohlen, die Sicherung nicht für andere Zwecke als die Sicherung zu verwenden und auf Engine-Ebene wiederherzustellen. Dadurch wird die Änderung beim Abrufen 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.

Header

Wird in Esent.h deklariert.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Unicode

Wird als JetBackupInstanceW (Unicode) und JetBackupInstanceA (ANSI) implementiert.

Weitere Informationen

JET_ERR
JET_GRBIT
JET_INSTANCE
JET_PFNSTATUS
JetRestore
JetRestore2
JetRestoreInstance
JetStopServiceInstance
Systemparameter