MongoDB\Driver\Session::startTransaction
(mongodb >=1.5.0)
MongoDB\Driver\Session::startTransaction — Starts a transaction
Descrierea
$options = ?
) : 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().
Parametri
-
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 Timpul maxim în milisecunde permis pentru rularea comenzii
commitTransaction.Dacă este specificat,
maxCommitTimeMStrebuie să fie un întreg pe 32 de biți mai mare sau egal cu zero.readConcern MongoDB\Driver\ReadConcern O preocupare de citire pentru a fi aplicată operațiunii.
Această opțiune este disponibilă în MongoDB 3.2+ și va rezulta într-o excepție în timpul execuției dacă e specificată pentru o versiune mai veche a serverului.
readPreference MongoDB\Driver\ReadPreference Preferința de citire pentru a fi folosită la selectarea serverului pentru operațiune.
writeConcern MongoDB\Driver\WriteConcern O preocupare de înscriere pentru a fi aplicată operațiunii.
Valorile întoarse
Nu este întoarsă nici o valoare.
Erori/Excepții
- Emite MongoDB\Driver\Exception\InvalidArgumentException în cazul erorilor la interpretarea argumentelor.
- Throws MongoDB\Driver\Exception\CommandException if the transaction could not be started because of a server-side problem (e.g. a lock could not be obtained).
- Throws MongoDB\Driver\Exception\RuntimeException if the transaction could not be started (e.g. a transaction was already started).
Istoricul schimbărilor
| Versiune | Descriere |
|---|---|
| PECL mongodb 1.6.0 |
The |
A se vedea și
- MongoDB\Driver\Manager::startSession() - Start a new client session for use with this client
- MongoDB\Driver\Session::commitTransaction() - Commits a transaction
- MongoDB\Driver\Session::abortTransaction() - Aborts a transaction
add a note
