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