MongoDB\Driver\Server::executeBulkWriteCommand

(mongodb >=2.1.0)

MongoDB\Driver\Server::executeBulkWriteCommand — Выполняет операции записи на текущем сервере командой bulkWrite

Описание

final public function MongoDB\Driver\Server::executeBulkWriteCommand(MongoDB\Driver\BulkWriteCommand $bulk, ?array $options = null): MongoDB\Driver\BulkWriteCommandResult

Метод выполняет одну или несколько операций записи на текущем сервере командой » bulkWrite, которая появилась в MongoDB 8.0.

Объект класса MongoDB\Driver\BulkWriteCommand создают с одной или несколькими операциями записи: вставки, обновления или удаления. Каждую операцию записи возможно нацелить на разные коллекции.

Значение по умолчанию для опции "writeConcern" автоматически определяется на основе активной транзакции или URI-идентификатора соединения, если транзакция не содержит значения. На активную транзакцию указывает опция "session".

Список параметров

bulk (MongoDB\Driver\BulkWriteCommand)

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

options

**Опции**
Опция	Тип	Описание
session	MongoDB\Driver\Session	Сессия для связывания с операцией.
writeConcern	MongoDB\Driver\WriteConcern	Гарантия записи для применения к операции.

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

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

Ошибки

Метод выбрасывает исключение MongoDB\Driver\Exception\InvalidArgumentException, если параметр bulk не содержит ни одной операции записи.
Метод выбрасывает исключение MongoDB\Driver\Exception\InvalidArgumentException, если операции в параметре bulk уже выполнились. Объекты MongoDB\Driver\BulkWriteCommand невозможно выполнить многократно.
Выбрасывается MongoDB\Driver\Exception\InvalidArgumentException, если опция "session" указана в сочетании с неподтверждённой гарантией записи.
При ошибке парсинга аргумента метод выбрасывает исключение MongoDB\Driver\Exception\InvalidArgumentException.
При неудачном соединении с сервером (кроме ошибок аутентификации) метод выбрасывает исключение MongoDB\Driver\Exception\ConnectionException.
При неудачной аутентификации метод выбрасывает исключение MongoDB\Driver\Exception\AuthenticationException.
Метод выбрасывает исключение MongoDB\Driver\Exception\BulkWriteCommandException при ошибках записи наподобие сбоя команды, ошибки записи или ошибки подтверждения записи.
При других ошибках метод выбрасывает исключение MongoDB\Driver\Exception\RuntimeException.

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

MongoDB\Driver\BulkWriteCommand
MongoDB\Driver\BulkWriteCommandResult
MongoDB\Driver\WriteConcern
MongoDB\Driver\Manager::executeBulkWriteCommand() - Выполняет операции записи через команду bulkWrite

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

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

＋Добавить

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

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