MongoDB\Driver\Server::executeBulkWrite
(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 -
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 не могут быть выполнены несколько раз. - Выбрасывается MongoDB\Driver\Exception\InvalidArgumentException, если опция
"session"используется в сочетании с неподтвержденной гарантией записи. - При ошибке парсинга аргумента бросает исключение MongoDB\Driver\Exception\InvalidArgumentException.
- При неудачном соединении с сервером (кроме ошибок аутентификации), бросает исключение MongoDB\Driver\Exception\ConnectionException.
- При неудачной аутентификации бросает исключение MongoDB\Driver\Exception\AuthenticationException.
- При ошибке записи бросает исключение MongoDB\Driver\Exception\BulkWriteException.
- При ошибке парсинга аргумента бросает исключение MongoDB\Driver\Exception\InvalidArgumentException.
- При неудачном соединении с сервером (кроме ошибок аутентификации), бросает исключение MongoDB\Driver\Exception\ConnectionException.
- При неудачной аутентификации бросает исключение MongoDB\Driver\Exception\AuthenticationException.
- При возникновении других ошибок выбрасывает MongoDB\Driver\Exception\RuntimeException.
Список изменений
| Версия | Описание |
|---|---|
| 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.
|
Примечания
Замечание: Ответственность вызывающего кода заключается в том, что сервер в состоянии выполнять операцию записи. Например, выполнение операции записи на вторичном узле (исключая "локальную" базу данных) завершится неудачей.
Смотрите также
- MongoDB\Driver\BulkWrite
- MongoDB\Driver\WriteResult
- MongoDB\Driver\WriteConcern
- MongoDB\Driver\Manager::executeBulkWrite() - Выполняет одну или несколько операций записи