PHP.mk документација

MongoDB\Driver\BulkWrite::update

Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.

mongodb-driver-bulkwrite.update.php PHP.net прокси Преводот се освежува
Оригинал на PHP.net
Патека mongodb-driver-bulkwrite.update.php Локална патека за оваа страница.
Извор php.net/manual/en Оригиналниот HTML се реупотребува и локално се стилизира.
Режим Прокси + превод во позадина Кодовите, табелите и белешките остануваат читливи во истиот тек.
MongoDB\Driver\BulkWrite::update

Референца за `mongodb-driver-bulkwrite.update.php` со подобрена типографија и навигација.

mongodb-driver-bulkwrite.update.php

MongoDB\Driver\BulkWrite::update

класата MongoDB\Driver\BulkWrite

MongoDB\Driver\BulkWrite::updateДодај операција за ажурирање во bulk

= NULL

public function MongoDB\Driver\BulkWrite::update(array|object $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), документ за замена (т.е. only field: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. Оваа опција не може да биде true if newObj е документ за замена. false
sort array|object Наведете кој документ операцијата го ажурира ако барањето одговара на повеќе документи. Првиот документ што ќе се совпадне со редоследот на сортирање ќе биде ажуриран. Оваа опција не може да се користи ако "multi" is true. Оваа опција е достапна во MongoDB 8.0+ и ќе резултира со исклучок при извршување ако е специфицирана за постар сервер.
upsert bool Враќа filter не одговара на постоечки документ, вметнете single документ. Документот ќе биде креиран од newObj ако е документ за замена (т.е. нема оператори за ажурирање); инаку, операторите во newObj ќе бидат применети на filter за креирање на новиот документ. false

Вратени вредности

Не се враќа вредност.

Errors/Exceptions

Дневник на промени

Верзија = 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);

?>

Белешки од корисници

Нема белешки од корисници за оваа страница.
Навигација

Прелистувај сродни теми и функции.

На оваа страница

Автоматски outline од активната документација.

Насловите ќе се појават тука по вчитување.

Попрегледно читање

Примерите, changelog табелите и user notes се визуелно издвоени за да не се губат во долгата содржина.

Брз совет Користи го outline-от Скокни директно на главните секции од активната страница.
Извор Оригиналниот линк останува достапен Кога ти треба целосен upstream context, отвори го PHP.net во нов tab.