JetUpdate-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

JetUpdate-Funktion

Die JetUpdate -Funktion führt einen Aktualisierungsvorgang einschließlich Einfügen einer neuen Zeile in eine Tabelle oder eine vorhandene Zeile aktualisiert. Löschen einer Tabellenzeile erfolgt durch Aufrufen von JetDelete.

JetUpdate ist der letzte Schritt bei der Ausführung einer INSERT- oder Update. Das Update wird gestartet, indem Sie JetPrepareUpdate aufrufen und dann durch Aufrufen JetSetColumn oder JetSetColumns mindestens einmal zum Festlegen des Zustands der Datensatz. Schließlich wird JetUpdate aufgerufen, um den Aktualisierungsvorgang abzuschließen. Indizes werden nur von JetUpdate oder JetUpdate2und nicht während der JetSetColumn oder JetSetColumnsaktualisiert.

JET_ERR JET_API JetUpdate(
  __in          JET_SESID sesid,
  __in          JET_TABLEID tableid,
  __out_opt     void* pvBookmark,
  __in          unsigned long cbBookmark,
  __out_opt     unsigned long* pcbActual
);

Parameter

sesid

Die Sitzung für diesen Aufruf verwenden.

Tabellen-ID

Der Cursor für diesen Aufruf verwenden.

pvBookmark

Zeiger auf einen zurückgegebenen Lesezeichen für eine eingefügte Zeile.

cbBookmark

Die Größe des Puffers, auf die PvBookmark.

pcbActual

Die zurückgegebene Größe des Lesezeichens für die eingefügte Zeile in PvBookmarkzurückgegeben.

Return Value

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

Bei Erfolg wird der open Update-Operation für den Cursor abgeschlossen. Wenn eine AUTOINCREMENT-Spalte für die Tabelle definiert ist, wird dieser Wert für die eingefügten Datensätze festgelegt. Wenn eine Spalte Version für die Tabelle definiert ist, ist der Wert initialisiert für neu eingefügte Datensätze oder erhöht, jedes Mal, wenn ein Datensatz ersetzt wird. Alle Indizes, einschließlich gruppierte und nicht gruppierte Indizes werden aktualisiert.

Bei einem Fehler werden keine Änderungen jeglicher Art an der Datenbank vorgenommen. Vor dem Einfügen und dem Ersetzen Rückruffunktionen möglicherweise aufgerufen wurde, aber nach Einfügen und ersetzen Rückrufe werden nicht haben aufgerufen, da diese eine Aktualisierung fehlschlagen verursachen können. Der Kopierpuffer Cursor bleibt im Zustand bereit, damit die Möglichkeit, die inkrementell behandeln Sie die Probleme, die Fehler verursacht haben, und wiederholen Sie den Update-Vorgang vorhanden ist.

Anmerkungen

Callback-Funktionen können registriert werden, um vor oder nach dem Einfügen, und vor oder nach dem Update aufgerufen werden.

Größenbeschränkungen für Datensatz werden durch JetUpdatevon JetSetColumnund im Allgemeinen nicht erzwungen.

Es ist wichtig zu verstehen, die Auswirkungen auf eine große Anzahl von Update-Vorgänge innerhalb einer einzelnen Transaktion ausführen. Jede Aktualisierung in der Datenbank muss vom Datenbankmodul im Versionsspeicher nachverfolgt werden. Der Versionsspeicher enthält eine live Aufzeichnung über die verschiedenen Versionen der einzelnen Datensatz oder Index-Einträge in der Datenbank, die alle aktiven Transaktionen sichtbar sind. Diese Versionen werden zur Unterstützung der Multi-versionierte Parallelitätssteuerung verwendet vom Datenbankmodul zum Unterstützen von Transaktionen mit Snapshot-Isolation verwendet. Sobald das Datenbankmodul zum Speichern dieser Versionen verwendeten Ressourcen erschöpft hat dann akzeptieren es nicht mehr weiter Änderungen bis einige Transaktionen geschlossen haben, damit diese Ressourcen freigegeben werden können. Wenn das Modul in diesem Zustand ist, schlägt mit JET_errVersionStoreOutOfMemory alle Updates fehl. Die verfügbaren Ressourcen für das Datenbankmodul zum Speichern dieser Versionen können JetSetSystemParameter mit JET_paramMaxVerPages und JET_paramGlobalMinVerPagesgesteuert werden.

Voraussetzungen

Siehe auch

JET_ERR
JET_SESID
JET_TABLEID
JetDelete
JetPrepareUpdate
JetRegisterCallback
JetRetrieveColumn
JetRetrieveColumns
JetSetColumn
JetSetColumns
JetSetSystemParameter
Systemparameter