Windows Dev Center

Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original

JetExternalRestore-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

Die Funktion JetExternalRestore stellt eine externe Sicherung, die mit der externen Streamingsicherungs-APIs aufgenommen wurde und gibt einen Nummernbereich Log File während des Wiederherstellungsvorgangs wiedergeben wieder her. Dies wird als hard Recovery bezeichnet die ähnelt jedoch anders als Wiederherstellung wie von der Funktion JetInit ausgeführt wird.

JET_ERR JET_API JetExternalRestore(
  __in          JET_PSTR szCheckpointFilePath,
  __in          JET_PSTR szLogPath,
  __in_opt      JET_RSTMAP* rgrstmap,
  __in          long crstfilemap,
  __in          JET_PSTR szBackupLogPath,
  __in          long genLow,
  __in          long genHigh,
  __in          JET_PFNSTATUS pfn
);

Parameter

szCheckpointFilePath

Der Pfad für die Prüfpunktdatei während der Wiederherstellung zu verwenden, wenn SzTargetInstanceCheckpointPath nicht angegeben ist oder bereits eine Instanz des aktive oder ausgeführt wird hat.

szLogPath

Der Pfad oder ein Verzeichnis für die Protokolle für die letzte Phase (rückgängig) der Wiederherstellung und möglicherweise die Roll forward-Protokolle. Dieser Pfad kann die SzBackupLogPathidentisch sein.

rgrstmap

Dies ist ein Array von JET_RSTMAP -Strukturen. Dies ist eine Zuordnung alte und neue Datenbankpfade oder Dateinamen. Wird verwendet, da die Datenbanken müssen möglicherweise auf einem anderen Speicherort als dem Speicherort wiederhergestellt werden, die sie aus gesichert wurden. Im Fall, in denen mehrere Datenbanken zu einem einzelnen Protokollierung Satz zugeordnet sind, kann die Plan zur Wiederherstellung eine Teilmenge der Datenbanken wiederherstellen angeben.

crstfilemap

Die Anzahl der Einträge im Rgrstmap Array-Parameter.

szBackupLogPath

Der Pfad zu dem Verzeichnis, in dem die Protokolldateien wiederhergestellt werden. Dies sind die Protokolle, die während der externen backup Sequenz deaktiviert gelesen wurden. Dieser Pfad kann die SzLogPath identisch sein.

genLow

Die Anzahl der niedrigsten-Datei, die aus SzBackupLogPathwiedergegeben werden. Die vollständige Originaltreue für eine nicht signierte lange erhalten bleiben sollen, aber diese Nummer wird in der aktuellen Version des Moduls eine hexadezimale Zahl im Bereich von 0x00000 bis 0xFFFFF. Dies kann in zukünftigen Versionen ändern.

genHigh

Die Anzahl der höchsten-Datei, die aus SzBackupLogPathwiedergegeben werden. Die vollständige Originaltreue für eine nicht signierte lange erhalten bleiben sollen, aber diese Nummer wird in der aktuellen Version des Moduls eine hexadezimale Zahl im Bereich von 0x00000 bis 0xFFFFF. Dies kann in zukünftigen Versionen ändern.

pfn

Der Statusrückruf, um den Fortschritt der Wiederherstellung.

Return Value

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

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errOutOfMemory

Der Vorgang fehlgeschlagen ist, da nicht genügend Speicher zugewiesen werden konnte, um es abzuschließen.

JET_errInvalidParameter

Einer der bereitgestellten Parameter einen unerwarteten Wert oder oder enthalten ein Werts, das nicht mit dem Wert eines anderen Parameters kombiniert keinen Sinn. Dies kann usw. für JetExternalRestore, auftreten, wenn die SzTargetCheckpointPath und die SzTargetInstanceLogPath sind nicht angegeben oder nicht beide nicht angegeben. D. h., übereinstimmen sie müssen, und angegeben Sie beide oder angegeben Sie beide nicht.

JET_errDatabaseCorrupted

Dies gibt an, die Datenbank wurde beschädigt, oder eine unbekannte Datei.

JET_errFileNotFound

Der Vorgang fehlgeschlagen ist, da die angeforderte Datei nicht öffnen kann, da es unter dem angegebenen Pfad nicht gefunden werden konnte.

JET_errInvalidPath

Der Vorgang fehlgeschlagen ist, da es sich bei der angegebene Pfad nicht gefunden werden konnte.

JET_errRestoreOfNonBackupDatabase

Dieser Fehler wird zurückgegeben, wenn während die Datenbankdatei angegeben Wiederherstellen einer Datenbank ist nicht, die mit externen Sicherung gesichert wurde.

JET_errStartingRestoreLogTooHigh

Dieser Fehler wird zurückgegeben, wenn eine der in der SzBackupLogPath, die Protokolldateien hat eine Protokollgenerierung unten, die vom angegebenen GenLow oder pLogInfo.ulGenLow.

JET_errEndingRestoreLogTooLow

Dieser Fehler wird zurückgegeben, wenn anzuschauen die Protokolldateien in die SzBackupLogPathhat eine Protokollgenerierung über, in GenHigh oder pLogInfo.ulGenHighangegeben.

JET_errBadRestoreTargetInstance

Die angegebene SzTargetInstanceLogPath gehört nicht zu einer initialisierte Instanz. Dieser Fehler wird nur in Windows XP und höheren Versionen zurückgegeben werden.

JET_errRunningInOneInstanceMode

Das Datenbankmodul kann nicht externen Wiederherstellung oder hard Recovery im Einzelinstanz-Modus ausgeführt werden. Dieser Fehler wird nur in Windows XP und höheren Versionen zurückgegeben werden.

Bei Erfolg sind alle Datenbanken aus der Rgrstmap vollständig und in einer Neuinstallation oder wiederhergestellte konsistenten Status. Die Datenbank kann zu diesem Zeitpunkt eine vorhandene Instanz erneut bereitgestellt werden.

Bei einem Fehler konnte das Modul nicht die Datenbank wiederherstellen. Die Datenbank befindet sich in einem ungültigen Zustand und, um hard Recovery wiederholen die gesamte Datenbank wiederhergestellt werden muss erneut. In der Regel die Quelle der diese Situation ist Datenträger oder Protokolldateien Beschädigung oder eine andere Form von Protokolldateien fehlerhafte Verwaltung oder einen nicht zusammenhängenden Protokoll festgelegt.

Anmerkungen

Zum Verständnis der Funktionsweise von "harten" Wiederherstellungs müssen Sie wissen, dass es drei Phasen der Wiederherstellung gibt, und die zweite Phase aus zwei Teilen bestehen kann. In Phase I Protokolle werden benötigt, um eine gesicherte Datenbank Konsistenz Unterlagen (oder eine Reihe von inkrementellen Protokolle verwendet werden kann). In Phase II werden alle zusätzlichen Roll forward-Protokolle, die verfügbar sind verbraucht, um die Datenbank konsistent verwendet werden. Es gibt auch eine Wiederholung der zusätzliche Roll forward-Protokolle. Phase III ist die rückgängig-Phase der Wiederherstellung.

Phase I: die Wiedergabe von der Satz von Protokollen, die für die Datenbank in einen konsistenten Zustand wiederhergestellt werden müssen (oder einer Reihe von Protokolldateien) erfolgt. Dies ist im Wesentlichen die Wiedergabe des Satzes von Protokolldateien, die nicht für die wiederhergestellten Datenbanken optional sind. Wenn es Protokolle aus diesem Bereich von Protokollen fehlen, schlägt die Wiederherstellung fehl. Diese Protokolle sollten in das Verzeichnis, in der SzBackupLogPath -Parameter angegeben werden.

Phase II: Optional können Sie möglicherweise einige Sätze von Protokolldateien Roll forward-Protokolldateien, die aus inkrementelle oder differenzielle Sicherungen und die Protokolldateien einer aktiven Instanz stammen. Im Fall von Protokolldateien aus inkrementelle oder differenzielle Sicherungen, das Protokoll, die Dateien in den Verzeichnissen, die in der SzBackupLogPath oder die SzTargetInstanceLogPath -Parameter angegebene platziert werden können, mit der früheren das empfohlene Verzeichnis. Die Protokolle für die Roll forward Phase (Phase II) verwendet sollten stammen aus derselben Serie von Protokollen während der Phase I wiedergegeben und kontinuierlich beginnende Protokoll Zahlen mit keine Lücken in den Protokolldateien Phase I haben. Um eine Datenbank auf dem neuesten Stand mit den Protokolldateien, die derzeit von einer aktiven Instanz verwendet werden, um wiederzugeben, müssen die SzTargetInstanceLogPath und SzTargetInstanceCheckpointPath -Parameter angegeben werden. Dies ist möglich, während die anderen Datenbanken, die dieses Protokoll Set zugeordnet sind.

Phase III: In der letzten Phase der Wiederherstellung, werden alle Transaktionen, ein Rollback der Generieren neuer Protokolldateien und aktualisieren die Prüfpunktdatei erfordert. Diese Phase wird manchmal als "Rückgängig" bezeichnet. Pfad für die Prüfpunktdatei während dieser Phase verwenden ist der Pfad für die Phase, d. h., III Protokollspeicherort Analog, wenn SzLogPath für Phase III verwendet wird, SzCheckpointFilePath verwendet werden, wenn SzTargetInstanceLogPath für Phase III der Wiederherstellung verwendet wird SzTargetInstanceCheckpointPath verwendet werden.

Damit Sie verstehen, wie die Pfade verwendet werden, verwenden Sie dieses Flussdiagramm:

ESE_Documentation_ese1

Voraussetzungen

-Client,

Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.

Server

WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server benötigt.

Kopfzeile

In Esent.h deklariert.

Library

Verwenden Sie ESENT.lib.

DLL

Erfordert "ESENT.dll".

Unicode

Implementiert als JetExternalRestoreW (Unicode) und JetExternalRestoreA (ANSI).

Siehe auch

Anzeigen:
© 2015 Microsoft