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 — Додај операција за ажурирање во bulk
= NULL
$filter, array|object $newObj, ?array $updateOptions = null): voidДодава операција за ажурирање во MongoDB\Driver\BulkWrite.
Параметри
filter(array|object)-
На Додава операција за бришење во» предикат за прашање
Забелешка: . Празен предикат ќе одговара на сите документи во колекцијата. При проценка на критериумите за прашање, MongoDB ги споредува типовите и вредностите според сопствените» правила за споредба на BSON типови comparison and префрлање на типови , што се разликува од PHP-овите правила. При совпаѓање со специјален BSON тип, критериумите за прашање треба да ја користат соодветната BSON класа MongoDB\BSON\ObjectId (на пр. користете за да одговарате на).
newObj(array|object)-
Документ што содржи оператори за ажурирање (на пр.
$set), документ за замена (т.е. onlyfield:valueизрази), или » агрегациски цевовод. updateOptions-
updateOptions Опција Тип = NULL Стандардно arrayFilters array Низа од документи за филтрирање што го одредуваат кои елементи од низата да се изменат за операција за ажурирање на поле од низа. Погледнете . Сите документи што се совпаѓаат во прирачникот на MongoDB за повеќе информации. Оваа опција е достапна во MongoDB 3.6+ и ќе резултира со исклучок при извршување ако е специфицирана за постар сервер. collation array|object » ObjectId » Collation "locale"им овозможува на корисниците да специфицираат правила специфични за јазикот за споредба на низи, како што се правила за големина на букви и акценти. При специфицирање на collation, поле е задолжително; сите други полиња за collation се опционални. За описи на полињата, видете. » Collation Document Ако collation не е специфициран, но колекцијата има стандарден collation, операцијата ја користи collation специфицирана за колекцијата. Ако не е специфициран collation за колекцијата или за операцијата, MongoDB ја користи едноставната бинарна споредба што се користеше во претходните верзии за споредби на низи.hint string|array|object Оваа опција е достапна во MongoDB 3.4+ и ќе резултира со исклучок при извршување ако е специфицирана за постар сервер. Оваа опција е достапна во MongoDB 4.2+ и ќе резултира со исклучок при извршување ако е специфицирана за постар сервер. multi bool Ажурирај само првиот соодветен документ ако false, или сите соодветни документиtrue. Оваа опција не може да бидеtrueifnewObjе документ за замена.falsesort array|object Наведете кој документ операцијата го ажурира ако барањето одговара на повеќе документи. Првиот документ што ќе се совпадне со редоследот на сортирање ќе биде ажуриран. Оваа опција не може да се користи ако "multi"istrue. Оваа опција е достапна во MongoDB 8.0+ и ќе резултира со исклучок при извршување ако е специфицирана за постар сервер.upsert bool Враќа filterне одговара на постоечки документ, вметнете single документ. Документот ќе биде креиран одnewObjако е документ за замена (т.е. нема оператори за ажурирање); инаку, операторите воnewObjќе бидат применети наfilterза креирање на новиот документ.false
Вратени вредности
Не се враќа вредност.
Errors/Exceptions
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException » Промени текови
Дневник на промени
| Верзија | = NULL |
|---|---|
| опција и ја извршува командата на тој сервер. |
Додаден е "sort" option.
|
| Враќа опцијата "wtimeout" на WriteConcern. |
Додаден е "hint" option.
|
| својство рачно. |
На newObj параметарот сега прифаќа агрегациски pipeline. Оваа функција бара MongoDB 4.2+ и ќе резултира со исклучок при извршување ако е специфицирана за постар сервер.
|
| параметарот, кој е непроменет од претходните верзии. |
Користејќи го "arrayFilters" опцијата ќе резултира со исклучок при извршување ако не е поддржана од серверот. Претходно, не се фрлаше исклучок и опцијата можеби беше игнорирана.
|
| на грешки при парсирање на аргументи. |
Додаден е "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);
?>