(mongodb >=1.0.0)
MongoDB\Driver\Server::executeBulkWrite — Выполняет операции записи на сервере
$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
| Опция | Тип | Описание |
|---|---|---|
| session | MongoDB\Driver\Session |
Сессия для связывания с операцией. |
| writeConcern | MongoDB\Driver\WriteConcern |
Гарантия записи для применения к операции. |
Метод возвращает экземпляр класса MongoDB\Driver\WriteResult, если выполнился успешно.
bulk не содержит операций записи.
bulk.
Объекты MongoDB\Driver\BulkWrite нельзя выполнять многократно.
"session" указана в сочетании с неподтверждённой гарантией записи.
| Версия | Описание |
|---|---|
| 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.
|
Замечание: Ответственность вызывающего кода заключается в том, что сервер в состоянии выполнять операцию записи. Например, выполнение операции записи на вторичном узле (исключая «локальную» базу данных) завершится неудачей.