MongoDB\Driver\BulkWrite::__construct
(mongodb >=1.0.0)
MongoDB\Driver\BulkWrite::__construct — Створює новий об'єкт BulkWrite
Опис
public MongoDB\Driver\BulkWrite::__construct(?array $options = null)
Створює новий MongoDB\Driver\BulkWrite, який є об'єктом, що змінюється, до якого можуть бути додані одна і кілька операцій запису. Операції запису можуть бути виконані за допомогою MongoDB\Driver\Manager::executeBulkWrite()
Список параметрів
options(array)
options
| Опция | Тип | Опис | Значение по умолчанию |
|---|---|---|---|
| bypassDocumentValidation | bool | ||
Якщо true, дозволяє виконувати операції вставки або оновлення, щоб обійти перевірку рівня документа. |
Цей параметр доступний у MongoDB 3.2+ та ігнорується у старіших версіях сервера, які не підтримують перевірку рівня сервера.
false| | comment |mixed
Довільний коментар, що допомагає відстежити операцію за допомогою профільника бази даних, виводу CurrentOp та журналів.
Опція доступна в MongoDB 4.4+ і призведе до виключення під час виконання, якщо вказана для старої версії сервера.
| | let | array|object |
Карта імен та значень параметрів. Значення мають бути константами або закритими виразами, які посилаються на поля документа. До параметрів можна звертатися як до змінних у контексті агрегованого виразу (наприклад, $$var
Опція доступна в MongoDB 5.0+ і призведе до виключення під час виконання, якщо вказана для старої версії сервера.
| | ordered | bool | Відсортовані операції (true) виконується послідовно на сервері MongoDB, тоді як невідсортовані операції (false) відправляються на сервері у довільному порядку і можуть виконуватися паралельно. | true
Помилки
- При помилці парсингу аргумент кидає винятокMongoDB\Driver\Exception\InvalidArgumentException
список змін
| Версия | Опис |
|---|---|
| PECL mongodb 1.14.0 | Додані опції "comment"и"let" |
| PECL mongodb 1.1.0 | Добавлена опция"bypassDocumentValidation" |
Приклади
Приклад #1 Приклад використання MongoDB\Driver\BulkWrite::__construct()****
Результат виконання наведеного прикладу:
Добавлено 2 документ(ов)
Обновлено 1 документ(ов)
Слито 1 документ(ов)
Удалено 1 документ(ов)
Дивіться також
- MongoDB\Driver\Manager::executeBulkWrite() - Виконує одну або кілька операцій запису
- MongoDB\Driver\WriteResult