PHP 8.1.0 RC 4 available for testing

MongoDB\Driver\Server::executeBulkWrite

(mongodb >=1.0.0)

MongoDB\Driver\Server::executeBulkWriteВыполнить одну или несколько операций записи на сервере

Описание

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

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

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

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

namespace (string)

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

bulk (MongoDB\Driver\BulkWrite)

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

options

options
Опция Тип Описание
session MongoDB\Driver\Session

Сессия для связывания с операцией.

writeConcern MongoDB\Driver\WriteConcern

Гарантия записи для применения к операции.

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

В случае успешного выполнения возвращает MongoDB\Driver\WriteResult.

Ошибки

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

Версия Описание
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.

Примечания

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

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

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top