JetReadFile-Funktion

Gilt für: Windows | Windows Server

JetReadFile-Funktion

Die JetReadFile-Funktion ruft den Inhalt einer Datei ab, die mit JetOpenFile geöffnet wurde.

    JET_ERR JET_API JetReadFile(
      __in          JET_HANDLE hfFile,
      __out         void* pv,
      __in          unsigned long cb,
      __out_opt     unsigned long* pcbActual
    );

Parameter

hfFile

Das Handle der zu lesenden Datei.

pv

Ausgabepuffer, der die Dateidaten empfängt.

cb

Die maximale Größe des Ausgabepuffers in Bytes.

pcbActual

Empfängt die tatsächliche Menge der abgerufenen Dateidaten.

Rückgabewert

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

Bei Erfolg wird der nächste Datenblock aus der Datei in den Ausgabepuffer eingelesen. Die tatsächliche Anzahl der abgerufenen Bytes wird ebenfalls zurückgegeben. Der Dateioffset, bei dem der nächste Lesevorgang erfolgt, wird um diesen Betrag erweitert.

Bei einem Fehler ist der Zustand des Ausgabepuffers undefiniert. Der Fehler führt zum Abbruch des gesamten Sicherungsvorgangs für die instance. Unter Windows XP und höheren Versionen wird die Sicherung nicht abgebrochen, wenn beim Lesen einer Datenbankdatei ein Fehler aufgetreten ist. Die Sicherung dieser Datenbankdatei wird jedoch weiterhin abgebrochen, und das entsprechende Handle wird automatisch geschlossen.

Bemerkungen

Jeder Aufruf von JetReadFile mithilfe eines Handles, das bereits alle Daten in der zugrunde liegenden Datei zurückgegeben hat (z. B. ein vorheriger Aufruf, der weniger Bytes als die Größe des Ausgabepuffers zurückgegeben hat), ist immer erfolgreich, gibt aber null Bytes an Daten zurück.

Ein großer Ausgabepuffer sollte verwendet werden, um die Sicherungsleistung zu maximieren. Möglicherweise sind einige Experimente erforderlich, um den richtigen Kompromiss zwischen Ressourcenverbrauch und Durchsatz für eine bestimmte Situation zu finden. Der Ausgabepuffer sollte in jedem Fall nicht kleiner als 64 KB sein.

Mehrere gleichzeitige Aufrufe von JetReadFile mit demselben Dateihandle werden nicht unterstützt. Dies bedeutet, dass es nicht möglich ist, mehrere Puffer für das gleichzeitige Lesen für dieselbe Datei in die Warteschlange zu stellen, um einen hohen sequenziellen Durchsatz zu erzielen. Stattdessen sollte ein einzelner großer Puffer verwendet werden.

Wenn die instance so konfiguriert ist, dass die Datenbankseitenbereinigung aktiviert ist (siehe JET_paramZeroDatabaseDuringBackup in Systemparametern), werden gelöschte Daten als Nebeneffekt eines Aufrufs von JetReadFile für die Datenbankdatei entfernt.

Es ist sehr wichtig zu verstehen, wie Sicherungen und Datenbeschädigungen interagieren. Wenn die Datenbank-Engine während einer Sicherung Datenbeschädigungen erkennt, schlägt die Sicherung der betroffenen Datenbank oder der gesamten instance fehl. Dies ist eine bewusste Entwurfsentscheidung zum Schutz vor Datenverlust. Wenn die Datenbank-Engine eine Erfolgreiche Sicherung bei Vorliegen einer Datenbeschädigung zuließ, ist es möglich, dass eine ältere, nicht beschädigte Sicherung als Ergebnis verworfen werden kann. Dies wäre bedauerlich, da es möglich wäre, die Datenbeschädigung auf dem live instance zu beheben, indem diese Sicherung wiederhergestellt und alle Transaktionsprotokolldateien für diese Datenbank wiedergegeben werden. In diesem Szenario ohne Datenverlust wird davon ausgegangen, dass die zirkuläre Protokollierung nicht aktiviert ist (siehe JET_paramCircularLog unter Systemparameter).

Es ist auch wichtig zu verstehen, dass Streamingsicherungen, wenn Datenbeschädigungen vorliegen, der wahrscheinlichste Ort ist, an dem sie zuerst erkannt wird. Dies ist der Fall, da die Streamingsicherung der einzige Prozess ist, der routinemäßig jede einzelne Seite der Datenbankdatei überprüft. Es ist auch wahrscheinlich, dass die Streamingsicherung der erste Prozess sein wird, um die frühen Anzeichen eines Hardwarefehlers zu erkennen, die sich durch zeitweilige Datenbeschädigungsfehler manifestieren. Dies liegt an der Menge der durch die Sicherung abgerufenen Daten sowie der Geschwindigkeit, mit der sie abgerufen werden.

Datenbeschädigungen werden von der Datenbank-Engine durch die Verwendung von Blockprüfsummen erkannt. Diese Prüfsummen werden direkt vor dem Schreiben einer Datenbankseite festgelegt und auf einer Datenbankseite überprüft. Dieses Schema ermöglicht es der Datenbank-Engine, festzustellen, dass Daten zu einem bestimmten Zeitpunkt beschädigt wurden, aber es ermöglicht der Datenbank-Engine nicht, die Quelle dieser Beschädigung zu ermitteln. In der Vergangenheit wurde festgestellt, dass die hauptursachen für solche Beschädigungen aus anderen Quellen als der Datenbank-Engine selbst stammen.

Anforderungen

Weitere Informationen

JET_ERR
JET_HANDLE
JET_INSTANCE
JetOpenFile
JetStopService
Systemparameter