In MongoDB die db.collection.update() -Methode ändert ein vorhandenes Dokument oder Dokumente in einer Sammlung.
Standardmäßig wird nur ein einzelnes Dokument aktualisiert. Aber wenn multi: true angegeben ist, aktualisiert es alle Dokumente, die den Abfragekriterien entsprechen.
Ein einzelnes Dokument aktualisieren
Angenommen, wir haben die Sammlung namens pets mit folgenden Dokumenten:
{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" } Wir können ein einzelnes Dokument wie folgt aktualisieren:
db.pets.update(
{ type: "Dog" },
{ $set: { type: "Cow" } }
) Ergebnis:
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) Nur ein Dokument wurde aktualisiert. Dies wird bestätigt, wenn wir die Sammlung abfragen.
db.pets.find() Ergebnis:
{ "_id" : 1, "name" : "Wag", "type" : "Cow" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" } Mehrere Dokumente aktualisieren
Verwenden wir wieder die Originaldokumente:
{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }
Dieses Mal fügen wir multi: true hinzu zu unserem Aktualisierungsvorgang, um alle Dokumente zu aktualisieren, die den Abfragekriterien entsprechen:
db.pets.update(
{ type: "Dog" },
{ $set: { type: "Cow" } },
{ multi: true }
) Ergebnis:
WriteResult({ "nMatched" : 2, "nUpserted" : 0, "nModified" : 2 }) Diesmal wurden also zwei Dokumente abgeglichen und aktualisiert.
Sehen wir uns noch einmal unsere Sammlung an:
db.pets.find() Ergebnis:
{ "_id" : 1, "name" : "Wag", "type" : "Cow" }
{ "_id" : 2, "name" : "Bark", "type" : "Cow" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }
Wie erwartet haben beide Dokumente jetzt einen type von Cow .
Nach oben einfügen
Die db.collection.update() -Methode akzeptiert einen upsert Argument, mit dem Sie eine Upsert-Operation ausführen können.
Wenn upsert: true , wird das Dokument aktualisiert, wenn es eine Übereinstimmung mit den Filterkriterien gibt, aber wenn es keine Übereinstimmung gibt, wird ein neues Dokument eingefügt.
Beginnen wir wieder mit den Originaldokumenten:
{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" } Beispiel:
db.pets.update(
{ name: "Bubbles" },
{ $set: { type: "Fish" } },
{ upsert: true }
) Ergebnis:
WriteResult({
"nMatched" : 0,
"nUpserted" : 1,
"nModified" : 0,
"_id" : ObjectId("5fe2c925d9914101694102e1")
}) In diesem Fall gab es keine Übereinstimmungen, also wurde ein Dokument eingefügt.
Sehen wir uns die Sammlung an.
db.pets.find() Ergebnis:
{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }
{ "_id" : ObjectId("5fe2c925d9914101694102e1"), "name" : "Bubbles", "type" : "Fish" } Eingebettete Dokumente
Sie können auch db.collection.update() verwenden um eingebettete Dokumente zu aktualisieren.
Angenommen, wir haben das folgende Dokument:
{
"_id" : 1,
"name" : "Wag",
"type" : "Dog",
"specs" : {
"height" : 400,
"weight" : 15,
"color" : "brown"
}
} Wir können den folgenden Code verwenden, um das eingebettete Dokument zu aktualisieren.
db.pets.update({
_id: 1
}, {
$set: {
"specs.weight": 20,
"specs.color": "blue"
}
}) Ergebnis:
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) So können wir sehen, dass ein Dokument abgeglichen und geändert wurde.
Sehen wir uns das Dokument an.
db.pets.find({
_id: 1
}).pretty() Ergebnis:
{
"_id" : 1,
"name" : "Wag",
"type" : "Dog",
"specs" : {
"height" : 400,
"weight" : 20,
"color" : "blue"
}
} Wir können sehen, dass das eingebettete Dokument wie angegeben aktualisiert wurde.
Arrays
Lassen Sie uns db.collection.update() verwenden um ein Array zu aktualisieren.
Angenommen, wir haben das folgende Dokument:
{
"_id" : 1,
"name" : "Wag",
"type" : "Dog",
"awards" : [
"Top Dog",
"Best Dog",
"Biggest Dog"
]
} Lassen Sie uns zwei der Array-Elemente und den Namen des Hundes aktualisieren.
db.pets.update({
_id: 1
}, {
$set: {
"name": "Bark",
"awards.0": "Bottom Dog",
"awards.1": "Worst Dog"
}
}) Ergebnis:
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) Wir können sehen, dass ein Dokument abgeglichen und geändert wurde.
Und jetzt schauen Sie sich das Dokument an.
db.pets.find().pretty() Ergebnis:
{
"_id" : 1,
"name" : "Bark",
"type" : "Dog",
"awards" : [
"Bottom Dog",
"Worst Dog",
"Biggest Dog"
]
} Der arrayFilters-Parameter
Sie können auch die arrayFilters verwenden -Parameter und den positionellen $ Operator, um zu bestimmen, welche Array-Elemente aktualisiert werden sollen.
Angenommen, wir haben eine Sammlung namens players mit folgenden Dokumenten:
{ "_id" : 1, "scores" : [ 1, 5, 3 ] }
{ "_id" : 2, "scores" : [ 8, 17, 18 ] }
{ "_id" : 3, "scores" : [ 15, 11, 8 ] } Wir könnten die folgende Abfrage ausführen, um nur die Array-Elemente zu aktualisieren, deren Wert höher als ein bestimmter Betrag ist (in diesem Fall 10).
db.players.update(
{ scores: { $gte: 10 } },
{ $set: { "scores.$[e]" : 10 } },
{ arrayFilters: [ { "e": { $gte: 10 } } ] }
) Ergebnis:
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
Wie erwartet aktualisiert dies nur ein Dokument, obwohl zwei Dokumente den Kriterien entsprechen (weil wir multi: true nicht angegeben haben ).
So sehen die Dokumente jetzt aus.
db.players.find() Ergebnis:
{ "_id" : 1, "scores" : [ 1, 5, 3 ] }
{ "_id" : 2, "scores" : [ 8, 10, 10 ] }
{ "_id" : 3, "scores" : [ 15, 11, 8 ] } In Dokument 2 wurden zwei Array-Elemente aktualisiert, da diese Elemente den Kriterien entsprachen.
Weitere Informationen
Die db.collection.update() -Methode akzeptiert auch andere Parameter wie writeConcern , collation , und hint .
Siehe die MongoDB-Dokumentation für db.collections.update() für weitere Informationen.