« MongoDB\\Driver\\Manager::executeQueryMongoDB\\Driver\\Manager::executeReadWriteCommand »PHP ManualMongoDB\\Driver\\Manager

MongoDB\Driver\Manager::executeReadCommand

(mongodb >=1.4.0)

MongoDB\Driver\Manager::executeReadCommand — Виконує команду бази даних, яка читає

Опис

final public MongoDB\Driver\Manager::executeReadCommand(string $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

ОпцияТипОпис
readConcernMongoDB\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

Помилки

Дивіться також