MongoDB\Driver\Manager::executeReadWriteCommand
(mongodb >=1.4.0)
MongoDB\Driver\Manager::executeReadWriteCommand — Выполняет команду базы данных, которая читает и пишет
Описание
$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() - Выполняет команду базы данных, которая читает и пишет на сервере
add a note
