MongoDB\Driver\Manager::executeWriteCommand

(mongodb >=1.4.0)

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

Описание

final public function MongoDB\Driver\Manager::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, если выполнился успешно.

Ошибки

Выбрасывается исключение 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() - Выполняет команду базы данных, которая пишет на сервере

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

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

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