(mongodb >=1.4.0)
MongoDB\Driver\Manager::executeReadCommand — Ejecuta un comando de base de datos que lee
$db
, MongoDB\Driver\Command $command
, ?array $options
= null
): MongoDB\Driver\Cursor
Selecciona un servidor en función de la opción "readPreference"
y ejecuta el comando en este servidor.
Este método aplicará una lógica específica a los comandos que leen (por ejemplo
» distinct).
Los valores por omisión de las opciones "readPreference"
y
"readConcern"
serán deducidos a partir 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. |
readPreference | MongoDB\Driver\ReadPreference |
Una preferencia de lectura a utilizar para seleccionar un servidor para la operación. |
session | MongoDB\Driver\Session |
Una sesión a asociar 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.