MongoDB\Driver\Server::executeBulkWrite

(mongodb >=1.0.0)

MongoDB\Driver\Server::executeBulkWrite — Выполняет операции записи на сервере

Описание

final public function MongoDB\Driver\Server::executeBulkWrite(string $namespace, MongoDB\Driver\BulkWrite $bulk, ?array $options = null): MongoDB\Driver\WriteResult

Метод выполняет одну или несколько операций записи на первичном сервере.

Объект MongoDB\Driver\BulkWrite создают с одной или набором операций записи разного типа, например обновления, удаления и вставки. Драйвер попытается отправить операции одного типа на сервер как можно меньшим количеством запросов, чтобы сократить обращения к серверу.

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

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

namespace (string)

Полностью определённое имя (т. е. "databaseName.collectionName").

bulk (MongoDB\Driver\BulkWrite)

Записи для выполнения.

options

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

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

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

Ошибки

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

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

Версия	Описание
PECL-модуль mongodb 2.0.0	Параметр `options` больше не принимает объекты MongoDB\Driver\WriteConcern.
PECL-модуль mongodb 1.21.0	Передача объекта MongoDB\Driver\WriteConcern как опции параметра `options` устарела, а в версии 2.0 передачу объекта запретят.
PECL-модуль mongodb 1.4.4	Метод выбросит исключение MongoDB\Driver\Exception\InvalidArgumentException, если опцию `"session"` указать вместе с неподтверждаемым уровнем записи.
PECL-модуль mongodb 1.4.0	Третий параметр `options` стал массивом опций, но в целях обратной совместимости пока ещё принимает объект MongoDB\Driver\ReadPreference.
PECL-модуль mongodb 1.3.0	Метод выбрасывает исключение MongoDB\Driver\Exception\InvalidArgumentException, если параметр `bulk` не содержит операций записи. Раньше метод выбрасывал исключение MongoDB\Driver\Exception\BulkWriteException.

Примечания

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

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

MongoDB\Driver\BulkWrite
MongoDB\Driver\WriteResult
MongoDB\Driver\WriteConcern
MongoDB\Driver\Manager::executeBulkWrite() - Выполняет операции записи

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

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

＋Добавить

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

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