MongoDB\Driver\Session::commitTransaction

(mongodb >=1.5.0)

MongoDB\Driver\Session::commitTransaction — Commits a transaction

説明

final public function MongoDB\Driver\Session::commitTransaction(): void

Saves the changes made by the operations in the multi-document transaction and ends the transaction. Until the commit, none of the data changes made from within the transaction are visible outside the transaction.

パラメータ

この関数にはパラメータはありません。

戻り値

値を返しません。

エラー / 例外

Throws MongoDB\Driver\Exception\InvalidArgumentException on argument parsing errors.
Throws MongoDB\Driver\Exception\CommandException if the server could not commit the transaction (e.g. due to conflicts, network issues). In case the exception's MongoDB\Driver\Exception\CommandException::getResultDocument() has a "errorLabels" element, and this array contains a "TransientTransactionError" or "UnknownTransactionCommitResult" value, it is safe to re-try the whole transaction. In newer versions of the extension, MongoDB\Driver\Exception\RuntimeException::hasErrorLabel() should be used to test for this situation instead.
Throws MongoDB\Driver\Exception\RuntimeException if the transaction could not be committed (e.g. a transaction was not started).

参考

MongoDB\Driver\Manager::startSession() - Start a new client session for use with this client
MongoDB\Driver\Session::abortTransaction() - Aborts a transaction
MongoDB\Driver\Session::startTransaction() - Starts a transaction
MongoDB\Driver\Exception\RuntimeException::hasErrorLabel() - Returns whether an error label is associated with an exception

関連キーワード:

MongoDB Driver transaction Session Exception Commits commitTransaction Throws RuntimeException changes made commit CommandException exception hasErrorLabel client advanceOperationTime construct mongodb final Saves operations multi document ends