MongoDB\Driver\Session::startTransaction
(mongodb >=1.5.0)
MongoDB\Driver\Session::startTransaction — Starts a transaction
Descripción
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().
Parámetros
-
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 The maximum amount of time in milliseconds to allow a single
commitTransactioncommand to run.If specified,
maxCommitTimeMSmust be a signed 32-bit integer greater than or equal to zero.readConcern MongoDB\Driver\ReadConcern Un asunto de escritura a aplicar a la operación.
Esta opción está disponible en MongoDB 3.2+ y resultará en una excepción en tiempo de ejecución si es especificada para una versión de servidor más antigua.
readPreference MongoDB\Driver\ReadPreference Una preferencia de lectura a usar para seleccionar un servidor para la operación.
writeConcern MongoDB\Driver\WriteConcern Un asunto de escritura a aplicar a la operación.
Valores devueltos
No devuelve ningún valor.
Errores/Excepciones
- Lanza una MongoDB\Driver\Exception\InvalidArgumentException en errores de análisis de argumentos.
- 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).
Historial de cambios
| Versión | Descripción |
|---|---|
| PECL mongodb 1.6.0 |
The |
Ver también
- 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
