MongoDB\Driver\Manager::executeReadWriteCommand
(mongodb >=1.4.0)
MongoDB\Driver\Manager::executeReadWriteCommand — Виконує команду бази даних, яка читає та пише
Опис
final public MongoDB\Driver\Manager::executeReadWriteCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor
Виконує команду на основному сервері.
Цей метод буде застосовувати логіку, специфічну для команд, які читають та пишуть (наприклад, » aggregate) та враховують версію сервера MongoDB. Параметри "readConcern"и"writeConcern"по умолчанию соответствуют соответствующим значениям изURI підключення MongoDB
Список параметрів
db(string)
Ім'я бази даних, у якій запускається команда.
command MongoDB\Driver\Command) .
Команда для виконання.
options
options
| Опция | Тип | Опис |
|---|---|---|
| readConcern | MongoDB\Driver\ReadConcern | |
| Гарантія для застосування до операції. |
Ця опція доступна в MongoDB 3.2+ і призведе до виключення під час виконання, якщо вказана для старої версії сервера.
| | session |MongoDB\Driver\Session
Сесія зв'язування з операцією.
| | writeConcern |MongoDB\Driver\WriteConcern
Гарантія запису для застосування до операції.
Увага
При использовании"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якщо опція
"session"вказано у поєднанні з непідтвердженою гарантією запису. - При помилці парсингу аргумент кидає винятокMongoDB\Driver\Exception\InvalidArgumentException
- При невдалому з'єднанні з сервером (крім помилок аутентифікації) кидає винятокMongoDB\Driver\Exception\ConnectionException
- У разі невдалої аутентифікації кидає винятокMongoDB\Driver\Exception\AuthenticationException
- Видає винятокMongoDB\Driver\Exception\RuntimeExceptionінших помилок (наприклад, неправильна команда).
список змін
| Версия | Опис |
|---|---|
| PECL mongodb 1.4.4 | MongoDB\Driver\Exception\InvalidArgumentException буде викинуто, якщо опція "session" використовується у поєднанні з непідтвердженим записом. |
Дивіться також
- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- MongoDB\Driver\Manager::executeCommand() - Виконує команду бази даних
- MongoDB\Driver\Manager::executeReadCommand() - Виконує команду бази даних, яка читає
- MongoDB\Driver\Manager::executeWriteCommand() - Виконує команду бази даних, що пише
- MongoDB\Driver\Server::executeReadWriteCommand() - Виконує команду бази даних, яка читає та пише на сервері