MongoDB\Driver\Server::executeQuery
(mongodb >=1.0.0)
MongoDB\Driver\Server::executeQuery — Execute a database query on this server
Descripción
$namespace, MongoDB\Driver\Query $query, array|MongoDB\Driver\ReadPreference|null $options = null): MongoDB\Driver\CursorExecutes the query on this server.
Nota: The
"readPreference"option does not control the server to which the driver issues the operation; it will always be executed on this server object. Instead, it may be used when issuing the operation to a secondary (from a replica set connection, not standalone) or mongos node to ensure that the driver sets the wire protocol accordingly or adds the read preference to the operation, respectively.
Parámetros
-
namespace(string) -
Un espacio de nombres completamente cualificado (p. ej.
"nombreBaseDatos.nombreColección"). -
query(MongoDB\Driver\Query) -
La consulta a ejecutar.
-
options -
options Option Type Description readPreference MongoDB\Driver\ReadPreference Una preferencia de lectura a usar para seleccionar un servidor para la operación.
session MongoDB\Driver\Session Una sesión a asociar con la operación.
Valores devueltos
Devuelve un MongoDB\Driver\Cursor en caso de éxito.
Errores/Excepciones
- Lanza una MongoDB\Driver\Exception\InvalidArgumentException en errores de análisis de argumentos.
- Lanza una MongoDB\Driver\Exception\ConnectionException si la conexión al servidor falla (por razones diferentes a la autenticación).
- Lanza una MongoDB\Driver\Exception\AuthenticationException si la autenticación es necesaria y falla.
- Throws MongoDB\Driver\Exception\RuntimeException on other errors (e.g. invalid query operators).
Historial de cambios
| Versión | Descripción |
|---|---|
| PECL mongodb 1.4.0 |
The third parameter is now an options array.
For backwards compatibility, this paramater will still accept a
MongoDB\Driver\ReadPreference object.
|
Ver también
- MongoDB\Driver\Cursor
- MongoDB\Driver\Query
- MongoDB\Driver\ReadPreference
- MongoDB\Driver\Manager::executeQuery() - Execute a database query
add a note
