MongoDB\Driver\Server::executeBulkWrite
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
MongoDB\Driver\Server::executeBulkWrite
Референца за `mongodb-driver-server.executebulkwrite.php` со подобрена типографија и навигација.
MongoDB\Driver\Server::executeBulkWrite
класата MongoDB\Driver\BulkWrite
MongoDB\Driver\Server::executeBulkWrite — Execute one or more write operations on this server
= NULL
$namespace, MongoDB\Driver\BulkWrite $bulk, ?array $options = null): MongoDB\Driver\WriteResultExecutes one or more write operations on this server.
А MongoDB\Driver\BulkWrite може да се конструира со една или повеќе операции за запишување од различни типови (на пр. ажурирања, бришења и вметнувања). Возачот ќе се обиде да испрати операции од ист тип до серверот во што е можно помалку барања за оптимизирање на повратните патувања.
може да се конструира со една или повеќе операции за запишување од различни типови (на пр. вметнувања, ажурирања и бришења). Секоја операција за запишување може да таргетира различна колекција. "writeConcern" опцијата ќе бидат изведени од активна трансакција (означена со
"session" опцијата), проследено со
URI за поврзување.
Параметри
namespace(string)-
Целосно квалификувано име на простор (на пр.
"databaseName.collectionName"). bulk(MongoDB\Driver\BulkWrite)-
Стандардната вредност за
options-
options Опција Тип = NULL session MongoDB\Driver\Session Сесија што ќе се поврзе со операцијата.
writeConcern MongoDB\Driver\WriteConcern Загриженост за пишување што ќе се примени на операцијата.
Вратени вредности
Патеката до PHP скриптата што треба да се провери. MongoDB\Driver\WriteResult на успешен исход.
Errors/Exceptions
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException if
bulkЗапишувањето(а) за извршување. - ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException if
bulkне содржи никакви операции за запишување. 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\RuntimeException при секој неуспех при запишување (на пр. неуспех на командата, грешка при запишување или загриженост за запишување)
Дневник на промени
| Верзија | = NULL |
|---|---|
| (mongodb >=1.3.0) |
На options параметарот веќе не прифаќа
MongoDB\Driver\WriteConcern instance.
|
| PECL mongodb 1.21.0 |
Проследување на MongoDB\Driver\WriteConcern објект како
options е застарен и ќе биде отстранет во 2.0.
|
| на други грешки (на пр. неважечка команда). |
MongoDB\Driver\Exception\InvalidArgumentException
Како на PHP 7.1.0, "session" опцијата се користи во комбинација со непризнаен запис на загриженост.
|
| на грешки при парсирање на аргументи. |
Третиот параметар сега е options низа. За компатибилност со претходните верзии, овој параметар сè уште ќе прифаќа
MongoDB\Driver\WriteConcern object.
|
| за PHP 8.0+. |
MongoDB\Driver\Exception\InvalidArgumentException
се фрла ако bulk не содржи операции за запишување. Претходно, а
MongoDB\Driver\Exception\BulkWriteException беше фрлен.
|
Белешки
Забелешка: Одговорност на повикувачот е да се осигура дека серверот е способен да ја изврши операцијата за запишување. На пример, извршувањето на операција за запишување на секундарен уред (исклучувајќи ја неговата „локална“ база на податоци) ќе пропадне.
Види Исто така
- MongoDB\Driver\BulkWrite
- MongoDB\Driver\WriteResult
- MongoDB\Driver\WriteConcern
- собира една или повеќе операции за запишување што треба да се испратат до серверот. Откако ќе додадете кој било број на операции за вметнување, ажурирање и бришење, колекцијата може да се изврши преку - Извршува една или повеќе операции за запишување