W MongoDB db.collection.update() metoda modyfikuje istniejący dokument lub dokumenty w kolekcji.
Domyślnie aktualizuje tylko jeden dokument. Ale jeśli multi: true jest określony, a następnie aktualizuje wszystkie dokumenty, które spełniają kryteria zapytania.
Aktualizuj pojedynczy dokument
Załóżmy, że mamy kolekcję o nazwie pets z następującymi dokumentami:
{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" } Możemy zaktualizować pojedynczy dokument w ten sposób:
db.pets.update(
{ type: "Dog" },
{ $set: { type: "Cow" } }
) Wynik:
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) Zaktualizowano tylko jeden dokument. Potwierdzamy to, gdy wysyłamy zapytanie do kolekcji.
db.pets.find() Wynik:
{ "_id" : 1, "name" : "Wag", "type" : "Cow" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" } Aktualizuj wiele dokumentów
Użyjmy ponownie oryginalnych dokumentów:
{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }
Tym razem dodamy multi: true do naszej operacji aktualizacji, aby zaktualizować wszystkie dokumenty, które spełniają kryteria zapytania:
db.pets.update(
{ type: "Dog" },
{ $set: { type: "Cow" } },
{ multi: true }
) Wynik:
WriteResult({ "nMatched" : 2, "nUpserted" : 0, "nModified" : 2 }) Więc tym razem dwa dokumenty zostały dopasowane i zaktualizowane.
Przyjrzyjmy się jeszcze raz naszej kolekcji:
db.pets.find() Wynik:
{ "_id" : 1, "name" : "Wag", "type" : "Cow" }
{ "_id" : 2, "name" : "Bark", "type" : "Cow" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }
Zgodnie z oczekiwaniami oba dokumenty mają teraz type Cow .
Do góry
db.collection.update() metoda akceptuje upsert argument, który umożliwia wykonanie operacji upsert.
Kiedy upsert: true , dokument jest aktualizowany, jeśli istnieje zgodność z kryteriami filtrowania, 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.update(
{ name: "Bubbles" },
{ $set: { type: "Fish" } },
{ upsert: true }
) Wynik:
WriteResult({
"nMatched" : 0,
"nUpserted" : 1,
"nModified" : 0,
"_id" : ObjectId("5fe2c925d9914101694102e1")
}) 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("5fe2c925d9914101694102e1"), "name" : "Bubbles", "type" : "Fish" } Osadzone dokumenty
Możesz także użyć db.collection.update() aby zaktualizować osadzone dokumenty.
Załóżmy, że mamy następujący dokument:
{
"_id" : 1,
"name" : "Wag",
"type" : "Dog",
"specs" : {
"height" : 400,
"weight" : 15,
"color" : "brown"
}
} Możemy użyć następującego kodu, aby zaktualizować osadzony dokument.
db.pets.update({
_id: 1
}, {
$set: {
"specs.weight": 20,
"specs.color": "blue"
}
}) Wynik:
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) Widzimy więc, że jeden dokument został dopasowany i zmodyfikowany.
Sprawdźmy dokument.
db.pets.find({
_id: 1
}).pretty() Wynik:
{
"_id" : 1,
"name" : "Wag",
"type" : "Dog",
"specs" : {
"height" : 400,
"weight" : 20,
"color" : "blue"
}
} Widzimy, że osadzony dokument został zaktualizowany zgodnie z opisem.
Tablice
Użyjmy db.collection.update() aby zaktualizować tablicę.
Załóżmy, że mamy następujący dokument:
{
"_id" : 1,
"name" : "Wag",
"type" : "Dog",
"awards" : [
"Top Dog",
"Best Dog",
"Biggest Dog"
]
} Zaktualizujmy dwa elementy tablicy i imię psa.
db.pets.update({
_id: 1
}, {
$set: {
"name": "Bark",
"awards.0": "Bottom Dog",
"awards.1": "Worst Dog"
}
}) Wynik:
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) Widzimy, że jeden dokument został dopasowany i zmodyfikowany.
A teraz spójrz na dokument.
db.pets.find().pretty() Wynik:
{
"_id" : 1,
"name" : "Bark",
"type" : "Dog",
"awards" : [
"Bottom Dog",
"Worst Dog",
"Biggest Dog"
]
} Parametr arrayFilters
Możesz także użyć arrayFilters parametr i pozycyjny $ operatora, aby określić, które elementy tablicy należy zaktualizować.
Załóżmy na przykład, ż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 ] } 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 10).
db.players.update(
{ scores: { $gte: 10 } },
{ $set: { "scores.$[e]" : 10 } },
{ arrayFilters: [ { "e": { $gte: 10 } } ] }
) Wynik:
WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
Zgodnie z oczekiwaniami aktualizuje to tylko jeden dokument, mimo że dwa dokumenty spełniają kryteria (ponieważ nie określiliśmy multi: true ).
Oto, jak teraz wyglądają dokumenty.
db.players.find() Wynik:
{ "_id" : 1, "scores" : [ 1, 5, 3 ] }
{ "_id" : 2, "scores" : [ 8, 10, 10 ] }
{ "_id" : 3, "scores" : [ 15, 11, 8 ] } W dokumencie 2 zaktualizowano dwa elementy tablicy, ponieważ te elementy spełniały kryteria.
Więcej informacji
db.collection.update() metoda akceptuje również inne parametry, takie jak writeConcern , collation i hint .
Zobacz dokumentację MongoDB dla db.collections.update() aby uzyskać więcej informacji.