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|MongoDB\Driver\WriteConcern|null $options = null): 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() - Виконує одну або кілька операцій запису