MongoDB\Driver\Server::executeQuery

(mongodb >=1.0.0)

MongoDB\Driver\Server::executeQuery — Execute a database query on this server

Описание

final public MongoDB\Driver\Cursor MongoDB\Driver\Server::executeQuery ( string $namespace , MongoDB\Driver\Query $query [, MongoDB\Driver\ReadPreference $readPreference ] )

Executes query on this server.

Замечание:
The readPreference parameter does not control the server to which the driver issues the query; the query will always be executed on this server object. Instead, it may be used when issuing the command 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 query document, respectively.

Список параметров

namespace (string): Полностью определенное имя (т.е. "databaseName.collectionName").
query (MongoDB\Driver\Query): The MongoDB\Driver\Query для выполнения.
readPreference (MongoDB\Driver\ReadPreference): Опционально MongoDB\Driver\ReadPreference для выбора сервера для этой операции. Если не задано, то он будет выбран из URI соединения MongoDB.

Возвращаемые значения

В случае успеха возвращает MongoDB\Driver\Cursor.

Ошибки

При ошибке парсинга аргумента бросает исключение MongoDB\Driver\Exception\InvalidArgumentException.
При неудачном соединении с сервером (кроме ошибок аутентификации), бросает исключение MongoDB\Driver\Exception\ConnectionException.
При неудачной аутентификации бросает исключение MongoDB\Driver\Exception\AuthenticationException.
Throws MongoDB\Driver\Exception\RuntimeException on other errors (e.g. invalid query operators).

Смотрите также

MongoDB\Driver\Cursor
MongoDB\Driver\Query
MongoDB\Driver\ReadPreference
MongoDB\Driver\Manager::executeQuery() - Execute a database query