Выполняет запрос к базе данных на сервере

Описание

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

Выполняет запрос на сервере.

Замечание: Опция "readPreference" не управляет сервером, которому драйвер выполняет операцию; он всегда будет выполняться на этом объекте сервера. Вместо этого его можно использовать при выдаче операции на вторичном сервере (из соединения с репликой, а не автономном) или узел mongos, чтобы гарантировать, что драйвер соответственно устанавливает проводной протокол или добавляет предпочтения чтения к операции, соответственно.

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

namespace (string)

Полностью определенное имя (т.е. "databaseName.collectionName").

query (MongoDB\Driver\Query)

Запрос для выполнения.

options

**options**
Опция	Тип	Описание
readPreference	MongoDB\Driver\ReadPreference	Предпочтение чтения, используемая для выбора сервера для выполнения операции.
session	MongoDB\Driver\Session	Сессия для связывания с операцией.

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

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

Ошибки

При ошибке парсинга аргумента бросает исключение MongoDB\Driver\Exception\InvalidArgumentException.
При неудачном соединении с сервером (кроме ошибок аутентификации), бросает исключение MongoDB\Driver\Exception\ConnectionException.
При неудачной аутентификации бросает исключение MongoDB\Driver\Exception\AuthenticationException.
Выдает исключение MongoDB\Driver\Exception\RuntimeException на другие ошибки (например, недопустимые операторы запросов).

Список изменений

Версия	Описание
1.4.0	Третий параметр теперь является массивом `options`. Для обратной совместимости этот параметр будет по-прежнему принимать объект MongoDB\Driver\ReadPreference.

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

MongoDB\Driver\Cursor
MongoDB\Driver\Query
MongoDB\Driver\ReadPreference
MongoDB\Driver\Manager::executeQuery() - Выполняет запрос к базе данных