PHP 8.6.0 Alpha 2 available for testing

MongoDB\Driver\Server::executeReadWriteCommand

(mongodb >=1.4.0)

MongoDB\Driver\Server::executeReadWriteCommandEjecuta un comando de base de datos que lee y escribe en este servidor

Descripción

final public function MongoDB\Driver\Server::executeReadWriteCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor

Ejecuta el comando en este servidor.

Este método aplicará una lógica específica a los comandos de lectura y escritura (por ejemplo » aggregate). Los valores por omisión para las opciones "readConcern" y "writeConcern" serán deducidos de una transacción activa (indicada por la opción "session"), seguida de la URI de conexión.

Parámetros

db (string)
El nombre de la base de datos sobre la cual se ejecutará el comando.
command (MongoDB\Driver\Command)
El comando a ejecutar.
options

options
Opción Tipo Descripción
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.
session MongoDB\Driver\Session Una sesión a asociar a la operación.
writeConcern MongoDB\Driver\WriteConcern Una preocupación de escritura a aplicar a la operación.

Advertencia

Si se utiliza una "session" que tiene una transacción en curso, no se puede especificar la opción "readConcern" o "writeConcern". Intentar hacer esto lanzará una excepción MongoDB\Driver\Exception\InvalidArgumentException . En su lugar, debe definir estas opciones cuando se crea la transacción con MongoDB\Driver\Session::startTransaction().

Valores devueltos

Retorna un MongoDB\Driver\Cursor en caso de éxito.

Errores/Excepciones

Historial de cambios

Versión Descripción
PECL mongodb 1.4.4 Una MongoDB\Driver\Exception\InvalidArgumentException será lanzada si la opción "session" es utilizada en combinación con un writeConcern no reconocido.

Notas

Nota: Es responsabilidad del llamante asegurarse de que el servidor sea capaz de ejecutar la operación de escritura. Por ejemplo, la ejecución de una operación de escritura en un secundario (excluyendo su base de datos "local") fallará.

Véase también

add a note

User Contributed Notes

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