(mongodb >=1.4.0)
MongoDB\Driver\Server::executeWriteCommand — Выполняет команду базы данных, которая пишет на сервере
$db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\CursorМетод выполняет команду на сервере.
Метод будет применять логику, специфичную для команд, которые пишут (например,
» drop).
Значение по умолчанию для параметра writeConcern метод
получит из активной транзакции (указывает параметр
session), за которой следует
URI-идентификатор соединения.
Замечание: Метод не предназначен для выполнения запросов » insert, » update, или » delete команд. Пользователям рекомендуется пользоваться методом MongoDB\Driver\Manager::executeBulkWrite() для этих операций.
db (string)Название базы данных, в которой запускается команда.
command (MongoDB\Driver\Command)Команда для выполнения.
options
| Опция | Тип | Описание |
|---|---|---|
| session | MongoDB\Driver\Session |
Сессия для связывания с операцией. |
| writeConcern | MongoDB\Driver\WriteConcern |
Гарантия записи для применения к операции. |
С парметром "session" и при незавершённых
транзакциях нельзя указать параметр "readConcern"
или "writeConcern". Это выбросит
исключение MongoDB\Driver\Exception\InvalidArgumentException.
Вместо этого две этих опции устанавливают методом
MongoDB\Driver\Session::startTransaction(), когда создают транзакцию.
Метод возвращает курсор MongoDB\Driver\Cursor, если выполнился успешно.
"session" указана с соответствующей транзакцией в сочетании с опцией "readConcern" или "writeConcern"."session" указана в сочетании с неподтверждённой гарантией записи.
| Версия | Описание |
|---|---|
| PECL mongodb 1.4.4 |
Метод выбросит исключение MongoDB\Driver\Exception\InvalidArgumentException,
если опция session используется в сочетании с неподтверждённой записью.
|
Замечание: Ответственность вызывающего кода заключается в том, что сервер в состоянии выполнять операцию записи. Например, выполнение операции записи на вторичном узле (исключая «локальную» базу данных) завершится неудачей.