MongoDB\Driver\BulkWriteCommand::updateOne
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
MongoDB\Driver\BulkWriteCommand::updateOne
Референца за `mongodb-driver-bulkwritecommand.updateone.php` со подобрена типографија и навигација.
MongoDB\Driver\BulkWriteCommand::updateOne
(mongodb >=2.1.0)
MongoDB\Driver\BulkWriteCommand::updateOne — Add an updateOne operation
= NULL
string
$namespace,array|object
$filter,array|object
$update,?array
$options = null): void
Add an updateOne operation to the
MongoDB\Driver\BulkWriteCommand. The first document matching filter in the collection identified by
namespace will be updated.
Параметри
namespace(string)-
Целосно квалификувано име на простор (на пр.
"databaseName.collectionName"). filter(array|object)-
На Додава операција за бришење во» предикат за прашање
Забелешка: . Празен предикат ќе одговара на сите документи во колекцијата. При проценка на критериумите за прашање, MongoDB ги споредува типовите и вредностите според сопствените» правила за споредба на BSON типови comparison and префрлање на типови , што се разликува од PHP-овите правила. При совпаѓање со специјален BSON тип, критериумите за прашање треба да ја користат соодветната BSON класа MongoDB\BSON\ObjectId (на пр. користете за да одговарате на).
update(array|object)-
A document containing either update operators (e.g.
$set) or an » aggregation pipeline. options-
options Опција Тип = NULL Стандардно arrayFilters array An array of filter documents that determines which array elements to modify for an update operation on an array field. See » Specify arrayFilters for Array Update Operations in the MongoDB manual for more information.
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 updates if the query matches multiple documents. The first document matched by the sort order will be updated.
upsert bool Враќа filterdoes not match an existing document, insert a single document. The document will be created by applying operators inupdateto any field values infilter.false
Вратени вредности
Не се враќа вредност.
Errors/Exceptions
- ). Ако повикот не успее, ќе врати MongoDB\Driver\Exception\InvalidArgumentException » Промени текови
Примери
Пример #1 MongoDB\Driver\BulkWriteCommand::updateOne() example
<?php
$manager = new MongoDB\Driver\Manager;
$bulk = new MongoDB\Driver\BulkWriteCommand;
$bulk->updateOne('db.coll', ['x' => 1], ['$set' => ['y' => 2]]);
$result = $manager->executeBulkWriteCommand($bulk);
?>Види Исто така
- MongoDB\Driver\BulkWriteCommand::replaceOne() - Додај replaceOne операција
- MongoDB\Driver\BulkWriteCommand::updateMany() - Додај updateMany операција
- (mongodb >=2.1.0) - Извршува операции за запишување користејќи ја командата bulkWrite
- MongoDB\Driver\BulkWriteCommandResult