MongoDB\Driver\Server::executeWriteCommand
(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 -
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.
Ошибки
- Выбрасывается исключение 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\Server::executeCommand() - Выполнить команду базы данных на сервере
- MongoDB\Driver\Server::executeReadCommand() - Выполняет команду базы данных, которая читает на сервере
- MongoDB\Driver\Server::executeReadWriteCommand() - Выполняет команду базы данных, которая читает и пишет на сервере
- MongoDB\Driver\Manager::executeWriteCommand() - Выполняет команду базы данных, которая пишет
add a note
