PHP 8.4.1 Released!

MongoDB\Driver\Session::startTransaction

(mongodb >=1.5.0)

MongoDB\Driver\Session::startTransactionStarts a transaction

Beschreibung

final public MongoDB\Driver\Session::startTransaction(?array $options = null): void

Starts a multi-document transaction associated with the session. At any given time, you can have at most one open transaction for a session. After starting a transaction, the session object must be passed to each operation via the "session" option (e.g. MongoDB\Driver\Manager::executeBulkWrite()) in order to associate that operation with the transaction.

Transactions can be committed through MongoDB\Driver\Session::commitTransaction(), and aborted with MongoDB\Driver\Session::abortTransaction(). Transactions are also automatically aborted when the session is closed from garbage collection or by explicitly calling MongoDB\Driver\Session::endSession().

Parameter-Liste

options

Options can be passed as argument to this method. Each element in this options array overrides the corresponding option from the "defaultTransactionOptions" option, if set when starting the session with MongoDB\Driver\Manager::startSession().

options
Option Type Description
maxCommitTimeMS integer

Die maximale Dauer in Millisekunden, die ein einziger commitTransaction-Befehl beanspruchen darf.

Wenn angegeben, muss maxCommitTimeMS eine vorzeichenbehaftete 32-bit Ganzzahl größer als oder gleich Null sein.

readConcern MongoDB\Driver\ReadConcern

Ein Leseanliegen (Read Concern), das auf den Vorgang angewendet werden soll.

Diese Option ist ab MongoDB 3.2 verfügbar. Wenn sie für eine ältere Serverversion angegeben wird, kommt es bei der Ausführung zu einer Exception.

readPreference MongoDB\Driver\ReadPreference

Eine Lesepräferenz, die verwendet wird, um einen Server für die Operation auszuwählen.

writeConcern MongoDB\Driver\WriteConcern

Ein Schreibanliegen (Write Concern), das auf den Vorgang angewendet werden soll.

Rückgabewerte

Es wird kein Wert zurückgegeben.

Fehler/Exceptions

Changelog

Version Beschreibung
PECL mongodb 1.6.0

The "maxCommitTimeMS" option was added.

Siehe auch

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top