MongoDB\Driver\BulkWriteCommand::updateMany

(mongodb >=2.1.0)

MongoDB\Driver\BulkWriteCommand::updateMany — Add an updateMany operation

Beschreibung

public function MongoDB\Driver\BulkWriteCommand::updateMany(
    string $namespace,
    array|object $filter,
    array|object $update,
    ?array $options = null
): void

Add an updateMany operation to the MongoDB\Driver\BulkWriteCommand. All documents matching filter in the collection identified by namespace will be updated.

Parameter-Liste

namespace (string)

A fully qualified namespace (e.g. "databaseName.collectionName").

filter (array|object)

Das » Abfrage-PrÀdikat. Ein leeres PrÀdikat passt auf alle Dokumente in der Sammlung.

Hinweis: Bei der Auswertung von Abfragekriterien vergleicht MongoDB Typen und Werte gemĂ€ĂŸ seiner eigenen » Vergleichsregeln fĂŒr BSON-Typen, die sich von PHPs Regeln fĂŒr Typenvergleich und Typen-Jonglage unterscheidet. Wenn es eine Übereinstimmung mit einem speziellen BSON-Typ gibt, sollten die Abfragekriterien die entsprechende BSON-Klasse verwenden (z. B. MongoDB\BSON\ObjectId, um auf eine » ObjectId zu passen).

update (array|object)
A document containing either update operators (e.g. $set) or an » aggregation pipeline.
options

options
Option Type Description Default
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

Die » Collation (Vergleichs-/Sortierregel) ermöglicht es dem Benutzer, sprachspezifische Regeln fĂŒr den Vergleich von Zeichenketten anzugeben, so z. B. Regeln fĂŒr die Groß- und Kleinschreibung und Akzentzeichen. Bei der Angabe der Sortierung ist das Feld "locale" obligatorisch; alle anderen Sortierfelder sind optional. Die Beschreibungen der Felder sind unter » Collation Document zu finden.

Wenn keine Kollation angegeben wurde, aber die Sammlung eine Standardkollation hat, verwendet die Operation die fĂŒr die Sammlung angegebene Kollation. Wenn weder fĂŒr die Sammlung noch fĂŒr die Operation eine Kollation angegeben wurde, verwendet MongoDB den einfachen binĂ€ren Vergleich, der in frĂŒheren Versionen fĂŒr den Vergleich von Zeichenketten verwendet wurde.

Diese Option ist ab MongoDB 3.4 verfĂŒgbar. Wenn sie fĂŒr eine Ă€ltere Serverversion angegeben wird, kommt es bei der AusfĂŒhrung zu einer Exception.

hint string|array|object Index specification. Specify either the index name as a string or the index key pattern. If specified, then the query system will only consider plans using the hinted index.
upsert bool If filter does not match an existing document, insert a single document. The document will be created by applying operators in update to any field values in filter. false

RĂŒckgabewerte

Es wird kein Wert zurĂŒckgegeben.

Fehler/Exceptions

Beispiele

Beispiel #1 MongoDB\Driver\BulkWriteCommand::updateMany() example

<?php

$manager = new MongoDB\Driver\Manager;

$bulk = new MongoDB\Driver\BulkWriteCommand;
$bulk->updateMany('db.coll', ['x' => ['$gt' => 1]], ['$set' => ['y' => 2]]);

$result = $manager->executeBulkWriteCommand($bulk);

?>

Siehe auch

Found A Problem?

Learn How To Improve This Page ‱ Submit a Pull Request ‱ Report a Bug
add a note

User Contributed Notes

There are no user contributed notes for this page.