W MongoDB db.collection.updateMany() metoda aktualizuje wszystkie dokumenty, które pasują do określonego filtra dla kolekcji.
Przykład
Załóżmy, że mamy kolekcję o nazwie pets który zawiera następujące dokumenty:
{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }
Widzimy, że dwa dokumenty mają Dog jako ich type .
Możemy zaktualizować oba dokumenty jednocześnie w ten sposób:
db.pets.updateMany(
{ type: "Dog" },
{ $set: { type: "Cow" } }
) Wynik:
{ "acknowledged" : true, "matchedCount" : 2, "modifiedCount" : 2 } To pokazuje nam, że dwa dokumenty pasowały, a dwa zostały zaktualizowane.
Możemy sprawdzić kolekcję:
db.pets.find() Wynik:
{ "_id" : 1, "name" : "Wag", "type" : "Cow" }
{ "_id" : 2, "name" : "Bark", "type" : "Cow" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" } Do góry
db.collection.updateMany() metoda akceptuje upsert argument, który umożliwia wykonanie operacji upsert.
Kiedy upsert: true , wszystkie dokumenty spełniające kryteria filtru są aktualizowane, ale jeśli nie ma dopasowania, wstawiany jest nowy dokument.
Zacznijmy ponownie od oryginalnych dokumentów:
{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" } Przykład:
db.pets.updateMany(
{ name: "Bubbles" },
{ $set: { type: "Fish" } },
{ upsert: true }
) Wynik:
{
"acknowledged" : true,
"matchedCount" : 0,
"modifiedCount" : 0,
"upsertedId" : ObjectId("5fe27e1dd991410169410244")
} W tym przypadku nie było dopasowań, więc dokument został przesunięty.
Sprawdźmy kolekcję.
db.pets.find() Wynik:
{ "_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" } Osadzone dokumenty
Możesz także użyć db.collection.updateMany() aby zaktualizować osadzone dokumenty.
Załóżmy, że wstawiamy następujące 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"
}
}
]) Możemy użyć następującego kodu, aby zaktualizować osadzony dokument.
db.pets.updateMany({
type: "Dog"
}, {
$set: {
"specs.color": "brown",
"specs.gooddog": false
}
}) Wynik:
{ "acknowledged" : true, "matchedCount" : 2, "modifiedCount" : 2 } Widzimy więc, że oba dokumenty zostały zaktualizowane.
Sprawdźmy dokument.
db.pets.find({
type: "Dog"
}).pretty() Wynik:
{
"_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
}
} Widzimy, że osadzone dokumenty zostały zaktualizowane zgodnie z opisem.
Tablice
Użyjmy db.collection.updateMany() aby zaktualizować tablicę.
Załóżmy, że mamy kolekcję o nazwie players z następującymi dokumentami:
{ "_id" : 1, "scores" : [ 1, 5, 3 ] }
{ "_id" : 2, "scores" : [ 8, 17, 18 ] }
{ "_id" : 3, "scores" : [ 15, 11, 8 ] } Zaktualizujmy dwa elementy tablicy we wszystkich dokumentach.
db.players.updateMany({},
{
$set: {
"scores.0": 20,
"scores.1": 26
}
}) Wynik:
{ "acknowledged" : true, "matchedCount" : 3, "modifiedCount" : 3 }
Widzimy, że wszystkie trzy dokumenty zostały zaktualizowane. Dzieje się tak, ponieważ pozostawiłem puste kryteria filtrowania (użyłem {} dla kryteriów filtrowania).
I spójrzmy na dokument.
db.players.find() Wynik:
{ "_id" : 1, "scores" : [ 20, 26, 3 ] }
{ "_id" : 2, "scores" : [ 20, 26, 18 ] }
{ "_id" : 3, "scores" : [ 20, 26, 8 ] } Parametr arrayFilters
Możesz także użyć arrayFilters parametr i pozycyjny $ operatora, aby określić, które elementy tablicy należy zaktualizować.
Na przykład, patrząc na nasz poprzedni dokument:
{ "_id" : 1, "scores" : [ 20, 26, 3 ] }
{ "_id" : 2, "scores" : [ 20, 26, 18 ] }
{ "_id" : 3, "scores" : [ 20, 26, 8 ] } Moglibyśmy uruchomić następujące zapytanie, aby zaktualizować tylko te elementy tablicy, które mają wartość wyższą niż pewna kwota (w tym przypadku 15).
db.players.updateMany(
{ scores: { $gte: 15 } },
{ $set: { "scores.$[e]" : 15 } },
{ arrayFilters: [ { "e": { $gte: 15 } } ] }
) Wynik:
{ "acknowledged" : true, "matchedCount" : 3, "modifiedCount" : 3 } Zgodnie z oczekiwaniami wszystkie dokumenty spełniają kryteria i dlatego są aktualizowane. Jednak nie wszystkie elementy tablicy zostały zaktualizowane.
Oto, jak teraz wyglądają dokumenty.
db.players.find() Wynik:
{ "_id" : 1, "scores" : [ 15, 15, 3 ] }
{ "_id" : 2, "scores" : [ 15, 15, 15 ] }
{ "_id" : 3, "scores" : [ 15, 15, 8 ] } Jedynymi zaktualizowanymi elementami tablicy były te o wartości powyżej 15.
Więcej informacji
db.collection.updateMany() metoda akceptuje również inne parametry, takie jak writeConcern , collation i hint .
Zobacz dokumentację MongoDB dla db.collections.updateMany() aby uzyskać więcej informacji.