array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'mongodb-driver-manager.executewritecommand.php', 1 => 'MongoDB\\Driver\\Manager::executeWriteCommand', 2 => 'Выполняет команду базы данных, которая пишет', ), 'up' => array ( 0 => 'class.mongodb-driver-manager.php', 1 => 'MongoDB\\Driver\\Manager', ), 'prev' => array ( 0 => 'mongodb-driver-manager.executereadwritecommand.php', 1 => 'MongoDB\\Driver\\Manager::executeReadWriteCommand', ), 'next' => array ( 0 => 'mongodb-driver-manager.getencryptedfieldsmap.php', 1 => 'MongoDB\\Driver\\Manager::getEncryptedFieldsMap', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/mongodb/mongodb/driver/manager/executewritecommand.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

MongoDB\Driver\Manager::executeWriteCommand

(mongodb >=1.4.0)

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

Описание

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

Ошибки

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

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

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