(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 может быть создан с одной или несколькими операциями записи различного типа (например, обновления, удаления и вставки). Драйвер попытается отправить операции одного типа на сервер в виде как можно меньшего количества запросов для сокращения обращений к серверу.
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. |
Замечание: Ответственность вызывающего кода заключается в том, что сервер в состоянии выполнять операцию записи. Например, выполнение операции записи на вторичном узле (исключая «локальную» базу данных) завершится неудачей.