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