PHP Conference Kansai 2025

MongoDB\Driver\Manager::executeWriteCommand

(mongodb >=1.4.0)

MongoDB\Driver\Manager::executeWriteCommandEjecuta un comando de base de datos que escribe

Descripción

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

Ejecuta el comando en el servidor primario.

Este método aplicará una lógica específica a los comandos que escriben (por ejemplo » drop). Los valores por omisión de la opción "writeConcern" serán deducidos a partir de una transacción activa (indicada por la opción "session"), seguida de la URI de conexión.

Nota: Este método no está destinado a ser utilizado para ejecutar » insert, » update, o » delete. Se recomienda a los usuarios utilizar MongoDB\Driver\Manager::executeBulkWrite() para estas operaciones.

Parámetros

db (string)

El nombre de la base de datos en la que ejecutar el comando.

command (MongoDB\Driver\Command)

El comando a ejecutar.

options

options
Option Type Description
session MongoDB\Driver\Session

Una sesión a asociar con la operación.

writeConcern MongoDB\Driver\WriteConcern

Un asunto de escritura a aplicar a la operación.

Advertencia

Si se usa la opción "session" con sesión que tenga una transacción en progreso, no se puede especificar una opción "readConcern" o "writeConcern". Esto resultarña en una MongoDB\Driver\Exception\InvalidArgumentException. En su lugar se debería establecer estas dos opciones al crear la transacción con MongoDB\Driver\Session::startTransaction().

Valores devueltos

Devuelve 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.

Ver también

add a note

User Contributed Notes

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