MongoDB\Driver\Server::executeWriteCommand

(mongodb >=1.4.0)

MongoDB\Driver\Server::executeWriteCommandВыполняет команду базы данных, которая пишет на сервере

Описание

final public MongoDB\Driver\Server::executeWriteCommand(string $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

options
Опция Тип Описание
session MongoDB\Driver\Session

Сессия для связывания с операцией.

writeConcern MongoDB\Driver\WriteConcern

Гарантия записи для применения к операции.

Внимание

С парметром "session" и при незавершённых транзакциях нельзя указать параметр "readConcern" или "writeConcern". Это выбросит исключение MongoDB\Driver\Exception\InvalidArgumentException. Вместо этого две этих опции устанавливают методом MongoDB\Driver\Session::startTransaction(), когда создают транзакцию.

Возвращаемые значения

Метод возвращает курсор MongoDB\Driver\Cursor, если выполнился успешно.

Ошибки

Список изменений

Версия Описание
PECL mongodb 1.4.4 Метод выбросит исключение MongoDB\Driver\Exception\InvalidArgumentException, если опция session используется в сочетании с неподтверждённой записью.

Примечания

Замечание: Ответственность вызывающего кода заключается в том, что сервер в состоянии выполнять операцию записи. Например, выполнение операции записи на вторичном узле (исключая «локальную» базу данных) завершится неудачей.

Смотрите также

Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top