(mongodb >=1.4.0)
MongoDB\Driver\Server::executeWriteCommand — Ejecuta un comando de base de datos que escribe en este servidor
$db
, MongoDB\Driver\Command $command
, ?array $options
= null
): MongoDB\Driver\CursorEjecuta el comando en este servidor.
Este método aplicará una lógica específica a los comandos que escriben (por ejemplo
» drop).
El valor por omisión para la opción "writeConcern"
será deducido 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 comandos. Se recomienda a los usuarios utilizar MongoDB\Driver\Server::executeBulkWrite() para estas operaciones.
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
Option | Type | Description |
---|---|---|
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. |
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().
Retorna un MongoDB\Driver\Cursor en caso de éxito.
"session"
option is used with an associated transaction in combination with a "readConcern"
or "writeConcern"
option."session"
se utiliza junto con una preocupación de escritura no reconocida.
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.
|
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á.