array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'mongodb-driver-server.executebulkwrite.php', 1 => 'MongoDB\\Driver\\Server::executeBulkWrite', 2 => 'Выполняет операции записи на сервере', ), 'up' => array ( 0 => 'class.mongodb-driver-server.php', 1 => 'MongoDB\\Driver\\Server', ), 'prev' => array ( 0 => 'mongodb-driver-server.construct.php', 1 => 'MongoDB\\Driver\\Server::__construct', ), 'next' => array ( 0 => 'mongodb-driver-server.executebulkwritecommand.php', 1 => 'MongoDB\\Driver\\Server::executeBulkWriteCommand', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/mongodb/mongodb/driver/server/executebulkwrite.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 = null): MongoDB\Driver\WriteResult

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

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

Значение по умолчанию для параметра writeConcern метод получит из активной транзакции (указывает параметр session), за которой следует URI-идентификатор соединения.

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

namespace (string)

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

bulk (MongoDB\Driver\BulkWrite)

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

options

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

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

writeConcern MongoDB\Driver\WriteConcern

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

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

Метод возвращает экземпляр класса MongoDB\Driver\WriteResult, если выполнился успешно.

Ошибки

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

Версия Описание
PECL-модуль mongodb 2.0.0 Параметр options больше не принимает объекты MongoDB\Driver\WriteConcern.
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.

Примечания

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

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