MongoDB\Driver\Manager::executeWriteCommand
(mongodb >=1.4.0)
MongoDB\Driver\Manager::executeWriteCommand — Выполняет команду базы данных, которая пишет
Описание
$db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\CursorВыполняет команду на основном сервере.
Этот метод будет применять логику, специфичную для команд, которые пишут (например,
» drop) и
учитывают версию сервера MongoDB. Опция
"writeConcern" по умолчанию будет соответствовать
значению из URI
подключения MongoDB.
Замечание: Метод не предназначен для выполнения » insert, » update, или » delete команд. Пользователям рекомендуется использовать MongoDB\Driver\Manager::executeBulkWrite() для этих команд.
Список параметров
-
db(string) -
Имя базы данных, в которой запускается команда.
-
command(MongoDB\Driver\Command) -
Команда для выполнения.
-
options -
options Опция Тип Описание 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::executeReadWriteCommand() - Выполняет команду базы данных, которая читает и пишет
- MongoDB\Driver\Server::executeWriteCommand() - Выполняет команду базы данных, которая пишет на сервере
add a note
