MongoDB\Driver\BulkWriteCommand::replaceOne
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
MongoDB\Driver\BulkWriteCommand::replaceOne
Референца за `mongodb-driver-bulkwritecommand.replaceone.php` со подобрена типографија и навигација.
MongoDB\Driver\BulkWriteCommand::replaceOne
(mongodb >=2.1.0)
MongoDB\Driver\BulkWriteCommand::replaceOne — Додај операција replaceOne
= NULL
string
$namespace,array|object
$filter,array|object
$replacement,?array
$options = null): void
Додај операција replaceOne на
MongoDB\Driver\BulkWriteCommand. Првиот документ што одговара filter во колекцијата идентификувана со
namespace ќе биде заменет.
Параметри
namespace(string)-
Целосно квалификувано име на простор (на пр.
"databaseName.collectionName"). filter(array|object)-
На Додава операција за бришење во» предикат за прашање
Забелешка: . Празен предикат ќе одговара на сите документи во колекцијата. При проценка на критериумите за прашање, MongoDB ги споредува типовите и вредностите според сопствените» правила за споредба на BSON типови comparison and префрлање на типови , што се разликува од PHP-овите правила. При совпаѓање со специјален BSON тип, критериумите за прашање треба да ја користат соодветната BSON класа MongoDB\BSON\ObjectId (на пр. користете за да одговарате на).
replacement(array|object)- Документ за замена.
options-
options Опција Тип = NULL Стандардно collation array|object » ObjectId » Collation "locale"им овозможува на корисниците да специфицираат правила специфични за јазикот за споредба на низи, како што се правила за големина на букви и акценти. При специфицирање на collation, поле е задолжително; сите други полиња за collation се опционални. За описи на полињата, видете. » Collation Document Ако collation не е специфициран, но колекцијата има стандарден collation, операцијата ја користи collation специфицирана за колекцијата. Ако не е специфициран collation за колекцијата или за операцијата, MongoDB ја користи едноставната бинарна споредба што се користеше во претходните верзии за споредби на низи.hint string|array|object Оваа опција е достапна во MongoDB 3.4+ и ќе резултира со исклучок при извршување ако е специфицирана за постар сервер. sort array|object Наведете кој документ ќе го замени операцијата ако барањето одговара на повеќе документи. Првиот документ што ќе се совпадне според редоследот на сортирање ќе биде заменет. upsert bool Враќа filterне одговара на постоечки документ, вметнете single документ. Документот ќе биде креиран одreplacement.false
Вратени вредности
Не се враќа вредност.
Errors/Exceptions
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException » Промени текови
Примери
Пример #1 MongoDB\Driver\BulkWriteCommand::updateMany() example
<?php
$manager = new MongoDB\Driver\Manager;
$bulk = new MongoDB\Driver\BulkWriteCommand;
$bulk->replaceOne('db.coll', ['x' => 1], ['x' => 1, 'y' = 2]);
$result = $manager->executeBulkWriteCommand($bulk);
?>Види Исто така
- (mongodb >=2.1.0) - Додај updateOne операција
- » Наведете arrayFilters за операции за ажурирање на низи - Додај updateMany операција
- (mongodb >=2.1.0) - Извршува операции за запишување користејќи ја командата bulkWrite
- MongoDB\Driver\BulkWriteCommandResult