JetBeginTransaction-Funktion

Gilt für: Windows | Windows Server

JetBeginTransaction-Funktion

Die JetBeginTransaction-Funktion bewirkt, dass eine Sitzung eine Transaktion eingibt und einen neuen Speicherpunkt erstellt. Diese Funktion kann in einer einzelnen Sitzung mehrmals aufgerufen werden, um zusätzliche Speicherpunkte zu erstellen. Diese Speicherpunkte können verwendet werden, um Änderungen am Zustand der Datenbank selektiv beizubehalten oder zu verwerfen.

    JET_ERR JET_API JetBeginTransaction(
      __in          JET_SESID sesid
    );

Parameter

sesid

Die Sitzung, die für diesen Aufruf verwendet werden soll.

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 Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

Bei Erfolg befindet sich die bereitgestellte Sitzung innerhalb einer Transaktion. Wenn sich die Sitzung zuvor innerhalb einer Transaktion befand, wird ein neuer Speicherpunkt erstellt.

Bei einem Fehler bleibt der Transaktionszustand der Sitzung unverändert. Es wird keine Änderung des Datenbankzustands vorgenommen.

Bemerkungen

Die Datenbank-Engine stellt ein Momentaufnahme Isolationsmodell für ihre Transaktionen bereit. Dies bedeutet, dass, wenn eine Sitzung zum ersten Mal in einen Transaktionszustand wechselt, die gesamte Datenbank zu Beginn der Transaktion eingefroren wird. Eine Sitzung muss keine Daten lesen, da sie immer auf die entsprechende Version dieser Daten zugreifen kann. Dies bedeutet, dass eine Sitzung, die Daten aktualisiert, niemals verhindert, dass eine andere Sitzung diese Daten liest.

Eine weitere Folge der Verwendung von Momentaufnahme Isolation ist das Sperrmodell, das für Updates verwendet wird. Die Datenbank-Engine erteilt der ersten Sitzung, die sie anfordert, eine Schreibsperre für einen bestimmten Datenabschnitt. Diese Schreibsperre wird aufgehoben, wenn die Transaktion entweder committet oder vollständig abgebrochen wird, sodass sich die Sitzung nicht mehr in einer Transaktion befindet. Während eine Sitzung eine Schreibsperre enthält, wird jede andere Sitzung, die dieselbe Schreibsperre anfordert, erst blockiert, wenn die Schreibsperre verfügbar ist. Stattdessen schlägt diese zweite Sitzung sofort mit JET_errWriteConflict fehl. Um diesen Konflikt zu beheben, muss die zweite Sitzung ihre Transaktion vollständig abbrechen (oder committen), einige kurze Zeit warten, bis die erste Sitzung die Transaktion committet oder abbricht, und dann von vorne beginnen.

Um Momentaufnahme Isolation zu unterstützen, speichert die Datenbank-Engine alle Versionen aller geänderten Daten im Arbeitsspeicher seit dem zeitpunkt, zu dem die älteste aktive Transaktion in einer Sitzung zum ersten Mal gestartet wurde. Dies hat wichtige Auswirkungen auf Ihre Anwendung. Jedes Verhalten, das dazu führt, dass eine große Anzahl von Versionen im Arbeitsspeicher erstellt wird, kann dazu führen, dass der instance seine maximale Versionsspeichergröße aufgebraucht (weitere Informationen finden Sie unter JET_paramMaxVerPages unter Systemparameter). Ein solches Verhalten umfasst unter anderem sehr große Updates in einer einzelnen Transaktion und transaktionen mit sehr langer Ausführungsdauer. Daher ist es sehr wichtig, die Größe des Versionsspeichers für die erwartete Transaktionslast der Anwendung ordnungsgemäß zu konfigurieren. Es ist auch wichtig, die Anzahl der Updates, die in einer einzelnen Transaktion durchgeführt werden, zu begrenzen. Darüber hinaus ist es wichtig, Transaktionen in Szenarien mit hoher Auslastung so kurz wie möglich zu machen.

Es wird dringend empfohlen, dass sich die Anwendung immer im Kontext einer Transaktion befindet, wenn SIE ESE-APIs aufruft, die Daten abrufen oder aktualisieren. Wenn dies nicht der Fall ist, umschließt die Datenbank-Engine automatisch jeden ESE-API-Aufruf dieses Typs in einer Transaktion im Namen der Anwendung. Die Kosten dieser sehr kurzen Transaktionen können sich in einigen Fällen schnell summieren.

Das Standardverhalten der Engine besteht darin, die Verwendung einer Sitzung auf denselben Thread zu beschränken, ab dem Zeitpunkt, zu dem der erste Aufruf von JetBeginTransaction erfolgt, bis zu dem Zeitpunkt, zu dem der übereinstimmende Aufruf von JetCommitTransaction oder JetRollback erfolgt. Dieses Verhalten kann geändert werden, um diese Einschränkung durch Festlegen eines benutzerdefinierten Sitzungskontexts mithilfe von JetSetSessionContext und JetResetSessionContext zu entfernen.

Die Datenbank-Engine unterstützt auch Änderungen an Transaktionsschemas. Beispielsweise ist es möglich, eine neue Transaktion zu beginnen, eine Tabelle zu erstellen, ein paar Spalten hinzuzufügen, einen index oder zwei zu erstellen und die Transaktion dann abzubrechen. Die soeben hinzugefügten Schemaelemente werden aus der Datenbank entfernt. Es ist auch möglich, Schemaänderungen und gewöhnliche Datenbankupdates in derselben Transaktion zu kombinieren.

Anforderungen

Weitere Informationen

JET_ERR
JET_GRBIT
JET_SESID
JetCommitTransaction
JetGetSystemParameter
JetResetSessionContext
JetRollback
JetSetSessionContext
JetStopService
Systemparameter