PHP 8.6.0 Alpha 2 available for testing

MongoDB\Driver\Session::startTransaction

(mongodb >=1.5.0)

MongoDB\Driver\Session::startTransactionInicia una transacción

Descripción

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

Inicia una transacción multi-documento asociada a la sesión. En un momento dado, solo se puede tener una transacción abierta para una sesión. Después de iniciar una transacción, el objeto de sesión debe ser pasado a cada operación a través de la opción "session" (por ejemplo MongoDB\Driver\Manager::executeBulkWrite()) para asociar esta operación a la transacción.

Las transacciones pueden ser confirmadas a través de MongoDB\Driver\Session::commitTransaction(), y anuladas con MongoDB\Driver\Session::abortTransaction(). Las transacciones también se anulan automáticamente cuando la sesión se cierra por la recolección de basura o al llamar explícitamente a MongoDB\Driver\Session::endSession().

Parámetros

options
Las opciones pueden ser pasadas como argumento a este método. Cada elemento de este array de opciones reemplaza la opción correspondiente de la opción "defaultTransactionOptions", si se define al iniciar la sesión con MongoDB\Driver\Manager::startSession().

options
Opción Tipo Descripción
maxCommitTimeMS integer El tiempo máximo en milisegundos para permitir que una sola comando commitTransaction se ejecute. Si se especifica, maxCommitTimeMS debe ser un entero 32 bits con signo superior o igual a cero.
readConcern MongoDB\Driver\ReadConcern Una preocupación de lectura a aplicar a la operación. Esta opción está disponible en MongoDB 3.2+ y se traducirá en una excepción en el momento de la ejecución si se especifica para una versión más antigua del servidor.
readPreference MongoDB\Driver\ReadPreference Una preferencia de lectura a utilizar para seleccionar un servidor para la operación.
writeConcern MongoDB\Driver\WriteConcern Una preocupación de escritura a aplicar a la operación.

Valores devueltos

No se retorna ningún valor.

Errores/Excepciones

Historial de cambios

Versión Descripción
PECL mongodb 1.6.0

La opción "maxCommitTimeMS" fue añadida.

Véase también

add a note

User Contributed Notes

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