V MongoDB db.collection.update() metoda upravuje existující dokument nebo dokumenty v kolekci.
Ve výchozím nastavení aktualizuje pouze jeden dokument. Ale pokud multi: true je zadáno, pak aktualizuje všechny dokumenty, které odpovídají kritériím dotazu.
Aktualizovat jeden dokument
Předpokládejme, že máme kolekci nazvanou pets s následujícími dokumenty:
{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" } Můžeme aktualizovat jeden dokument takto:
db.pets.update(
{ type: "Dog" },
{ $set: { type: "Cow" } }
) Výsledek:
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) Aktualizován byl pouze jeden dokument. To se potvrdí, když se na kolekci dotazujeme.
db.pets.find() Výsledek:
{ "_id" : 1, "name" : "Wag", "type" : "Cow" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" } Aktualizovat více dokumentů
Použijme znovu původní dokumenty:
{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }
Tentokrát přidáme multi: true k naší aktualizační operaci k aktualizaci všech dokumentů, které odpovídají kritériím dotazu:
db.pets.update(
{ type: "Dog" },
{ $set: { type: "Cow" } },
{ multi: true }
) Výsledek:
WriteResult({ "nMatched" : 2, "nUpserted" : 0, "nModified" : 2 }) Takže tentokrát byly spárovány a aktualizovány dva dokumenty.
Podívejme se znovu na naši sbírku:
db.pets.find() Výsledek:
{ "_id" : 1, "name" : "Wag", "type" : "Cow" }
{ "_id" : 2, "name" : "Bark", "type" : "Cow" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }
Podle očekávání mají nyní oba dokumenty type z Cow .
Upsert
db.collection.update() metoda přijímá upsert argument, který vám umožní provést operaci upsert.
Když upsert: true , dokument se aktualizuje, pokud existuje shoda s kritérii filtru, ale pokud žádná shoda není, vloží se nový dokument.
Začněme znovu původními dokumenty:
{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" } Příklad:
db.pets.update(
{ name: "Bubbles" },
{ $set: { type: "Fish" } },
{ upsert: true }
) Výsledek:
WriteResult({
"nMatched" : 0,
"nUpserted" : 1,
"nModified" : 0,
"_id" : ObjectId("5fe2c925d9914101694102e1")
}) V tomto případě nebyly nalezeny žádné shody, takže dokument byl přepsán.
Podívejme se na sbírku.
db.pets.find() Výsledek:
{ "_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" } Vložené dokumenty
Můžete také použít db.collection.update() k aktualizaci vložených dokumentů.
Předpokládejme, že máme následující dokument:
{
"_id" : 1,
"name" : "Wag",
"type" : "Dog",
"specs" : {
"height" : 400,
"weight" : 15,
"color" : "brown"
}
} K aktualizaci vloženého dokumentu můžeme použít následující kód.
db.pets.update({
_id: 1
}, {
$set: {
"specs.weight": 20,
"specs.color": "blue"
}
}) Výsledek:
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) Můžeme tedy vidět, že jeden dokument byl spárován a upraven.
Pojďme zkontrolovat dokument.
db.pets.find({
_id: 1
}).pretty() Výsledek:
{
"_id" : 1,
"name" : "Wag",
"type" : "Dog",
"specs" : {
"height" : 400,
"weight" : 20,
"color" : "blue"
}
} Vidíme, že vložený dokument byl aktualizován podle specifikace.
Pole
Použijme db.collection.update() aktualizovat pole.
Předpokládejme, že máme následující dokument:
{
"_id" : 1,
"name" : "Wag",
"type" : "Dog",
"awards" : [
"Top Dog",
"Best Dog",
"Biggest Dog"
]
} Pojďme aktualizovat dva prvky pole a jméno psa.
db.pets.update({
_id: 1
}, {
$set: {
"name": "Bark",
"awards.0": "Bottom Dog",
"awards.1": "Worst Dog"
}
}) Výsledek:
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) Vidíme, že jeden dokument byl spárován a upraven.
A teď se podívejte na dokument.
db.pets.find().pretty() Výsledek:
{
"_id" : 1,
"name" : "Bark",
"type" : "Dog",
"awards" : [
"Bottom Dog",
"Worst Dog",
"Biggest Dog"
]
} Parametr arrayFilters
Můžete také použít arrayFilters parametr a poziční $ operátor k určení, které prvky pole se mají aktualizovat.
Předpokládejme například, že máme kolekci nazvanou players s následujícími dokumenty:
{ "_id" : 1, "scores" : [ 1, 5, 3 ] }
{ "_id" : 2, "scores" : [ 8, 17, 18 ] }
{ "_id" : 3, "scores" : [ 15, 11, 8 ] } Mohli bychom spustit následující dotaz, abychom aktualizovali pouze ty prvky pole, které mají hodnotu vyšší než určité množství (v tomto případě 10).
db.players.update(
{ scores: { $gte: 10 } },
{ $set: { "scores.$[e]" : 10 } },
{ arrayFilters: [ { "e": { $gte: 10 } } ] }
) Výsledek:
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
Podle očekávání to aktualizuje pouze jeden dokument, i když dva dokumenty odpovídají kritériím (protože jsme nezadali multi: true ).
Takto nyní dokumenty vypadají.
db.players.find() Výsledek:
{ "_id" : 1, "scores" : [ 1, 5, 3 ] }
{ "_id" : 2, "scores" : [ 8, 10, 10 ] }
{ "_id" : 3, "scores" : [ 15, 11, 8 ] } V dokumentu 2 byly aktualizovány dva prvky pole, protože tyto prvky odpovídaly kritériím.
Další informace
db.collection.update() metoda také přijímá další parametry, jako je writeConcern , collation a hint .
Viz dokumentaci MongoDB pro db.collections.update() pro více informací.