MongoDB\Driver\Server::executeQuery
(mongodb >=1.0.0)
MongoDB\Driver\Server::executeQuery — Выполняет запрос к базе данных на сервере
Описание
$namespace, MongoDB\Driver\Query $query, array|MongoDB\Driver\ReadPreference|null $options = null): 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 на другие ошибки (например, недопустимые операторы запросов).
Список изменений
| Версия | Описание |
|---|---|
| PECL mongodb 1.4.0 |
Третий параметр теперь является массивом options.
Для обратной совместимости этот параметр будет по-прежнему принимать
объект MongoDB\Driver\ReadPreference.
|
Смотрите также
- MongoDB\Driver\Cursor
- MongoDB\Driver\Query
- MongoDB\Driver\ReadPreference
- MongoDB\Driver\Manager::executeQuery() - Выполняет запрос к базе данных
add a note
