(mongodb >=1.4.0)
MongoDB\Driver\Server::executeReadWriteCommand — Ejecuta un comando de base de datos que lee y 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 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.
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 |
---|---|---|
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. |
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á.