(mongodb >=1.0.0)
MongoDB\Driver\Server::executeBulkWrite — Выполняет одну или несколько операций записи на сервере
$namespace, MongoDB\Driver\BulkWrite $bulk, array|MongoDB\Driver\WriteConcern|null $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
метод выбрасывает исключение MongoDB\Driver\Exception\InvalidArgumentException.bulk,
выбрасывается исключение MongoDB\Driver\Exception\InvalidArgumentException.
Объекты MongoDB\Driver\BulkWrite нельзя выполнять несколько раз."session" указана в сочетании с неподтверждённой гарантией записи.
| Версия | Описание |
|---|---|
| PECL mongodb 1.4.4 |
Если опция session используется в сочетании
с неподтверждённой гарантией записи, выбрасывается исключение
MongoDB\Driver\Exception\InvalidArgumentException.
|
| PECL mongodb 1.4.0 |
Третий параметр теперь — массив options.
Для обратной совместимости этот параметр всё равно будет принимать объект
MongoDB\Driver\ReadPreference.
|
| PECL mongodb 1.3.0 |
Если параметр bulk не содержит операций записи,
выбрасывается исключение MongoDB\Driver\Exception\InvalidArgumentException.
Раньше метод выбрасывал исключение MongoDB\Driver\Exception\BulkWriteException.
|
Замечание: Ответственность вызывающего кода заключается в том, что сервер в состоянии выполнять операцию записи. Например, выполнение операции записи на вторичном узле (исключая «локальную» базу данных) завершится неудачей.