V MongoDB db.collection.updateMany()
metoda aktualizuje všechny dokumenty, které odpovídají zadanému filtru pro kolekci.
Příklad
Předpokládejme, že máme sbírku nazvanou pets
který obsahuje následující dokumenty:
{ "_id" : 1, "name" : "Wag", "type" : "Dog" } { "_id" : 2, "name" : "Bark", "type" : "Dog" } { "_id" : 3, "name" : "Meow", "type" : "Cat" }
Vidíme, že dva dokumenty mají Dog
jako jejich type
.
Oba dokumenty můžeme aktualizovat najednou takto:
db.pets.updateMany(
{ type: "Dog" },
{ $set: { type: "Cow" } }
)
Výsledek:
{ "acknowledged" : true, "matchedCount" : 2, "modifiedCount" : 2 }
To nám ukazuje, že dva dokumenty se shodovaly a dva byly aktualizovány.
Můžeme zkontrolovat 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" }
Upsert
db.collection.updateMany()
metoda přijímá upsert
argument, který vám umožní provést operaci upsert.
Když upsert: true
, všechny dokumenty, které odpovídají kritériím filtru, jsou aktualizovány, ale pokud žádná shoda nenastane, 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.updateMany(
{ name: "Bubbles" },
{ $set: { type: "Fish" } },
{ upsert: true }
)
Výsledek:
{ "acknowledged" : true, "matchedCount" : 0, "modifiedCount" : 0, "upsertedId" : ObjectId("5fe27e1dd991410169410244") }
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("5fe27e1dd991410169410244"), "name" : "Bubbles", "type" : "Fish" }
Vložené dokumenty
Můžete také použít db.collection.updateMany()
k aktualizaci vložených dokumentů.
Předpokládejme, že vložíme následující dokumenty:
db.pets.insertMany([
{
"_id" : 1,
"name" : "Wag",
"type" : "Dog",
"specs" : {
"height" : 400,
"weight" : 15,
"color" : "white"
}
},
{
"_id" : 2,
"name" : "Bark",
"type" : "Dog",
"specs" : {
"height" : 200,
"weight" : 12,
"color" : "white"
}
}
])
K aktualizaci vloženého dokumentu můžeme použít následující kód.
db.pets.updateMany({
type: "Dog"
}, {
$set: {
"specs.color": "brown",
"specs.gooddog": false
}
})
Výsledek:
{ "acknowledged" : true, "matchedCount" : 2, "modifiedCount" : 2 }
Takže vidíme, že oba dokumenty byly aktualizovány.
Pojďme zkontrolovat dokument.
db.pets.find({
type: "Dog"
}).pretty()
Výsledek:
{ "_id" : 1, "name" : "Wag", "type" : "Dog", "specs" : { "height" : 400, "weight" : 15, "color" : "brown", "gooddog" : false } } { "_id" : 2, "name" : "Bark", "type" : "Dog", "specs" : { "height" : 200, "weight" : 12, "color" : "brown", "gooddog" : false } }
Vidíme, že vložené dokumenty byly aktualizovány podle specifikace.
Pole
Použijme db.collection.updateMany()
aktualizovat pole.
Předpokládejme, ž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 ] }
Pojďme aktualizovat dva prvky pole ve všech dokumentech.
db.players.updateMany({},
{
$set: {
"scores.0": 20,
"scores.1": 26
}
})
Výsledek:
{ "acknowledged" : true, "matchedCount" : 3, "modifiedCount" : 3 }
Vidíme, že všechny tři dokumenty byly aktualizovány. Je to proto, že jsem nechal kritéria filtru prázdná (použil jsem {}
pro kritéria filtru).
A podívejme se na dokument.
db.players.find()
Výsledek:
{ "_id" : 1, "scores" : [ 20, 26, 3 ] } { "_id" : 2, "scores" : [ 20, 26, 18 ] } { "_id" : 3, "scores" : [ 20, 26, 8 ] }
Parametr arrayFilters
Můžete také použít arrayFilters
parametr a poziční $
operátor k určení, které prvky pole se mají aktualizovat.
Například při pohledu na náš předchozí dokument:
{ "_id" : 1, "scores" : [ 20, 26, 3 ] } { "_id" : 2, "scores" : [ 20, 26, 18 ] } { "_id" : 3, "scores" : [ 20, 26, 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ě 15).
db.players.updateMany(
{ scores: { $gte: 15 } },
{ $set: { "scores.$[e]" : 15 } },
{ arrayFilters: [ { "e": { $gte: 15 } } ] }
)
Výsledek:
{ "acknowledged" : true, "matchedCount" : 3, "modifiedCount" : 3 }
Podle očekávání všechny dokumenty splňují kritéria, a jsou proto aktualizovány. Ne všechny prvky pole však byly aktualizovány.
Takto nyní dokumenty vypadají.
db.players.find()
Výsledek:
{ "_id" : 1, "scores" : [ 15, 15, 3 ] } { "_id" : 2, "scores" : [ 15, 15, 15 ] } { "_id" : 3, "scores" : [ 15, 15, 8 ] }
Jediné prvky pole, které byly aktualizovány, byly ty s hodnotou vyšší než 15.
Další informace
db.collection.updateMany()
metoda také přijímá další parametry, jako je writeConcern
, collation
a hint
.
Viz dokumentaci MongoDB pro db.collections.updateMany()
pro více informací.