MongoDB\Driver\Server::executeQuery

MongoDB\Driver\Server::executeQuery

Ejecuta una consulta de base de datos en este servidor

Descripción#

php final public MongoDB\Driver\Server::executeQuery(string $namespace, MongoDB\Driver\Query $query, [array $options]): MongoDB\Driver\Cursorphp

Ejecuta la consulta en este servidor.

Los valores por omisión para la opción "readPreference" y la opción "readConcern" de la consulta se deducirán de una transacción activa (indicada por la opción "session"), luego por la URI de conexión.

[!NOTE] La opción "readPreference" no controla el servidor hacia el cual el controlador emite la operación; siempre se ejecutará en este objeto servidor. En su lugar, puede ser utilizado al emitir la operación a un secundario (desde una conexión de conjunto de réplicas, no autónoma) o el nodo Mongos para asegurarse de que el controlador defina el protocolo de fila en consecuencia o añada la preferencia de lectura a la operación, respectivamente.

Parámetros#

namespace (string)
Un espacio de nombres completamente calificado (ej. "databaseName.collectionName")

query (MongoDB\Driver\Query)
La consulta a ejecutar.

options
| Opción | Tipo | Descripción | |----|----|----| | 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. |

options

Valores devueltos#

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

Errores/Excepciones#

Lanza una excepción

MongoDB\Driver\Exception\InvalidArgumentException

en caso de error durante el análisis de un argumento.

Lanza una excepción

MongoDB\Driver\Exception\ConnectionException

si la conexión al servidor falla por una razón distinta a un problema de identificación

Lanza una excepción

MongoDB\Driver\Exception\AuthenticationException

si se requiere una identificación pero falla

Lanza una excepción

MongoDB\Driver\Exception\RuntimeException

si ocurre un error (i.e. operadores de consulta inválidos).

Historial de cambios#

Versión	Descripción
PECL mongodb 2.0.0	El parámetro options ya no acepta una instancia MongoDB\Driver\WriteConcern.
PECL mongodb 1.21.0	Pasar un objeto MongoDB\Driver\ReadPreference como options está obsoleto y será eliminado en la 2.0.
PECL mongodb 1.4.0	El tercer parámetro es ahora un array de options. Para la compatibilidad ascendente, este parámetro siempre aceptará un objeto MongoDB\Driver\ReadPreference.

Véase también#

MongoDB\Driver\Cursor

MongoDB\Driver\Query

MongoDB\Driver\ReadPreference

MongoDB\Driver\Manager::executeQuery