MongoDB\Driver\BulkWrite::update
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
MongoDB\Driver\BulkWrite::update
Референца за `mongodb-driver-bulkwrite.update.php` со подобрена типографија и навигација.
MongoDB\Driver\BulkWrite::update
класата MongoDB\Driver\BulkWrite
MongoDB\Driver\BulkWrite::update — Add an update operation to the bulk
= NULL
$filter, array|object $newObj, ?array $updateOptions = null): voidAdds an update operation to the MongoDB\Driver\BulkWrite.
Параметри
filter(array|object)-
На Додава операција за бришење во» предикат за прашање
Забелешка: . Празен предикат ќе одговара на сите документи во колекцијата. При проценка на критериумите за прашање, MongoDB ги споредува типовите и вредностите според сопствените» правила за споредба на BSON типови comparison and префрлање на типови , што се разликува од PHP-овите правила. При совпаѓање со специјален BSON тип, критериумите за прашање треба да ја користат соодветната BSON класа MongoDB\BSON\ObjectId (на пр. користете за да одговарате на).
newObj(array|object)-
Документ што содржи оператори за ажурирање (на пр.
$set), a replacement document (i.e. onlyfield:valueexpressions), or an » агрегациски цевовод. updateOptions-
updateOptions Опција Тип = NULL Стандардно arrayFilters array Низа од документи за филтрирање што го одредуваат кои елементи од низата да се изменат за операција за ажурирање на поле од низа. Погледнете » Specify arrayFilters for Array Update Operations во прирачникот на MongoDB за повеќе информации.
This option is available in MongoDB 3.6+ and will result in an exception at execution time if specified for an older server version.
collation array|object » ObjectId » Collation
"locale"им овозможува на корисниците да специфицираат правила специфични за јазикот за споредба на низи, како што се правила за големина на букви и акценти. При специфицирање на collation, поле е задолжително; сите други полиња за collation се опционални. За описи на полињата, видете.» Collation Document
Ако collation не е специфициран, но колекцијата има стандарден collation, операцијата ја користи collation специфицирана за колекцијата. Ако не е специфициран collation за колекцијата или за операцијата, MongoDB ја користи едноставната бинарна споредба што се користеше во претходните верзии за споредби на низи.
hint string|array|object Оваа опција е достапна во MongoDB 3.4+ и ќе резултира со исклучок при извршување ако е специфицирана за постар сервер.
This option is available in MongoDB 4.2+ and will result in an exception at execution time if specified for an older server version.
multi bool Update only the first matching document if false, or all matching documentstrue. This option cannot betrueifnewObjis a replacement document.falsesort array|object Наведете кој документ операцијата го ажурира ако барањето одговара на повеќе документи. Првиот документ што ќе се совпадне со редоследот на сортирање ќе биде ажуриран.
This option cannot be used if
"multi"istrue.This option is available in MongoDB 8.0+ and will result in an exception at execution time if specified for an older server version.
upsert bool Враќа filterне одговара на постоечки документ, вметнете single document. The document will be created fromnewObjif it is a replacement document (i.e. no update operators); otherwise, the operators innewObjwill be applied tofilterto create the new document.false
Вратени вредности
Не се враќа вредност.
Errors/Exceptions
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException » Промени текови
Дневник на промени
| Верзија | = NULL |
|---|---|
| PECL mongodb 1.21.0 |
Додаден е "sort" option.
|
| Враќа опцијата "wtimeout" на WriteConcern. |
Додаден е "hint" option.
|
| својство рачно. |
На newObj parameter now accepts an aggregation pipeline. This feature requires MongoDB 4.2+ and will result in an exception at execution time if specified for an older server version.
|
| PECL mongodb 1.5.0 |
Користејќи го "arrayFilters" option will result in an exception at execution time if unsupported by the server. Previously, no exception would be thrown and the option may have been ignored.
|
| на грешки при парсирање на аргументи. |
Додаден е "arrayFilters" option.
|
| PECL mongodb 1.3.0 |
Додаден е "collation" option.
|
Примери
Пример #1 MongoDB\Driver\BulkWrite::update() example
<?php
$bulk = new MongoDB\Driver\BulkWrite;
$bulk->update(
['x' => 2],
['$set' => ['y' => 3]],
['multi' => false, 'upsert' => false]
);
$manager = new MongoDB\Driver\Manager('mongodb://localhost:27017');
$result = $manager->executeBulkWrite('db.collection', $bulk);
?>