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 — Add a replaceOne operation
= NULL
string
$namespace,array|object
$filter,array|object
$replacement,?array
$options = null): void
Add a replaceOne operation to the
MongoDB\Driver\BulkWriteCommand. Првиот документ што одговара filter во колекцијата идентификувана со
namespace will be replaced.
Параметри
namespace(string)-
Целосно квалификувано име на простор (на пр.
"databaseName.collectionName"). filter(array|object)-
На Додава операција за бришење во» предикат за прашање
Забелешка: . Празен предикат ќе одговара на сите документи во колекцијата. При проценка на критериумите за прашање, MongoDB ги споредува типовите и вредностите според сопствените» правила за споредба на BSON типови comparison and префрлање на типови , што се разликува од PHP-овите правила. При совпаѓање со специјален BSON тип, критериумите за прашање треба да ја користат соодветната BSON класа MongoDB\BSON\ObjectId (на пр. користете за да одговарате на).
replacement(array|object)-
A replacement document.
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 Specify which document the operation replaces if the query matches multiple documents. The first document matched by the sort order will be replaced.
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\Driver\BulkWriteCommand::updateOne() - Додај updateOne операција
- » Наведете arrayFilters за операции за ажурирање на низи - Додај updateMany операција
- (mongodb >=2.1.0) - Извршува операции за запишување користејќи ја командата bulkWrite
- MongoDB\Driver\BulkWriteCommandResult