MongoDB\Driver\Server::executeReadCommand
(mongodb >=1.4.0)
MongoDB\Driver\Server::executeReadCommand — Виконує команду бази даних, яка читає на сервері
Опис
final public MongoDB\Driver\Server::executeReadCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor
Виконує команду на цьому сервері.
Цей метод застосовуватиме логіку, специфічну для команд, які читають (наприклад, » count) та враховують версію сервера MongoDB. Опція "readConcern" буде за умовчанням відповідати відповідному значенню з URI підключення MongoDB
Зауваження: Опция
"readPreference"не контролює сервер, якого драйвер виконує операцію; вона завжди виконуватиметься на цьому об'єкті сервера. Натомість, він може бути використаний при виконанні операції на другому вузлі (з набору реплік, не автономний) або на вузлі mongos для забезпечення того, що драйвер встановлює дротовий протокол відповідним чином або додає перевагу читання до операції відповідно.
Список параметрів
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\Server::executeCommand() - Виконати команду бази даних на сервері
- MongoDB\Driver\Server::executeReadWriteCommand() - Виконує команду бази даних, яка читає та пише на сервері
- MongoDB\Driver\Server::executeWriteCommand() - Виконує команду бази даних, що пише на сервері
- MongoDB\Driver\Manager::executeReadCommand() - Виконує команду бази даних, яка читає