(mongodb >=1.4.0)
MongoDB\Driver\Server::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
Опция | Тип | Описание |
---|---|---|
session | MongoDB\Driver\Session | Сессия для связывания с операцией. |
writeConcern | MongoDB\Driver\WriteConcern | Гарантия записи для применения к операции. |
При использовании "session"
и наличии незавершённых транзакций, вы не можете указать "readConcern"
or "writeConcern"
option. Это приведёт к выбрасыванию исключения 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" используется в сочетании с неподтверждённой записью. |
Замечание: Ответственность вызывающего кода заключается в том, что сервер в состоянии выполнять операцию записи. Например, выполнение операции записи на вторичном узле (исключая «локальную» базу данных) завершится неудачей.