PHP 8.5.0 Alpha 2 available for testing

MongoDB\Driver\Server::executeQuery

(mongodb >=1.0.0)

MongoDB\Driver\Server::executeQueryEjecuta una consulta de base de datos en este servidor

Descripción

final public MongoDB\Driver\Server::executeQuery(string $namespace, MongoDB\Driver\Query $query, ?array $options = null): MongoDB\Driver\Cursor

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.

Nota: 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

options
Option Type Description
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.

Valores devueltos

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

Errores/Excepciones

  • Lanza una excepción MongoDB\Driver\AuthenticationException si se requiere una identificación pero falla
  • Lanza una excepción MongoDB\Driver\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\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.

add a note

User Contributed Notes

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