MongoDB\Driver\Manager::executeReadCommand
(mongodb >=1.4.0)
MongoDB\Driver\Manager::executeReadCommand — Выполняет команду базы данных, которая читает
Описание
$db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor
Выбирает сервер в соответствии с опцией "readPreference"
и выполняет команду на сервере. По умолчанию будет использоваться предпочтение чтения из
URI подключения MongoDB.
Этот метод будет применять логику, специфичную для команд, которые читают (например,
» count)
и учитывают версию сервера MongoDB. Опция
"readConcern" будет по умолчанию соответствовать
соответствующему значению из URI
подключения MongoDB.
Список параметров
-
db(string) -
Имя базы данных, в которой запускается команда.
-
command(MongoDB\Driver\Command) -
Команда для выполнения.
-
options -
options Опция Тип Описание readConcern MongoDB\Driver\ReadConcern Гарантия чтения для применения к операции.
Эта опция доступна в MongoDB 3.2+ и приведёт к исключению во время выполнения, если указана для более старой версии сервера.
readPreference MongoDB\Driver\ReadPreference Предпочтение чтения, используемая для выбора сервера для выполнения операции.
session MongoDB\Driver\Session Сессия для связывания с операцией.
ВниманиеПри использовании
"session"и наличии незавершённых транзакций, вы не можете указать"readConcern"or"writeConcern"option. Это приведёт к выбрасыванию исключения MongoDB\Driver\Exception\InvalidArgumentException. Вместо этого вы должны установить эти две опции при создании транзакции с помощью MongoDB\Driver\Session::startTransaction().
Возвращаемые значения
В случае успешного выполнения возвращает MongoDB\Driver\Cursor.
Ошибки
- Выбрасывается исключение MongoDB\Driver\Exception\InvalidArgumentException, если опция
"session"указана с соответствующей транзакцией в сочетании с опцией"readConcern"или"writeConcern". - При ошибке парсинга аргумента бросает исключение MongoDB\Driver\Exception\InvalidArgumentException.
- При неудачном соединении с сервером (кроме ошибок аутентификации), бросает исключение MongoDB\Driver\Exception\ConnectionException.
- При неудачной аутентификации бросает исключение MongoDB\Driver\Exception\AuthenticationException.
- Выдаёт исключение MongoDB\Driver\Exception\RuntimeException для других ошибок (например, неверная команда).
Смотрите также
- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- MongoDB\Driver\Manager::executeCommand() - Выполняет команду базы данных
- MongoDB\Driver\Manager::executeReadWriteCommand() - Выполняет команду базы данных, которая читает и пишет
- MongoDB\Driver\Manager::executeWriteCommand() - Выполняет команду базы данных, которая пишет
- MongoDB\Driver\Server::executeReadCommand() - Выполняет команду базы данных, которая читает на сервере
add a note
