Aktualizacja MongoDBOne()

W MongoDB db.collection.updateOne() metoda aktualizuje pojedynczy dokument w kolekcji na podstawie filtra.

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" }

Możemy zaktualizować jeden dokument w ten sposób:

db.pets.updateOne( 
    { type: "Dog" },
    { $set: { type: "Cow" } }
    )

Wynik:

{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }

To zaktualizowało tylko jeden dokument, mimo że dwa dokumenty spełniają kryteria filtrowania (kryteria to type: "Dog" ).

Wyniki możemy sprawdzić w następujący sposób:

db.pets.find()

Wynik:

{ "_id" : 1, "name" : "Wag", "type" : "Cow" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }

Pierwszy dokument ma teraz type Cow zamiast Dog , ale nie miało to wpływu na drugi dokument, mimo że również spełniał kryteria filtrowania.

Do góry

db.collection.updateOne() 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.updateOne( 
    { name: "Bubbles" },
    { $set: { type: "Fish" } },
    { upsert: true }
    )

Wynik:

{
	"acknowledged" : true,
	"matchedCount" : 0,
	"modifiedCount" : 0,
	"upsertedId" : ObjectId("5fe1e94dd991410169410199")
}

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("5fe1e94dd991410169410199"), "name" : "Bubbles", "type" : "Fish" } 

Osadzone dokumenty

Możesz także użyć db.collection.updateOne() 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.updateOne({ 
    _id: 1 
    }, { 
        $set: { 
            "specs.weight": 20, 
            "specs.color": "blue"
        } 
})

Wynik:

{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }

Widzimy więc, że jeden dokument został zaktualizowany.

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.updateOne() 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.updateOne({ 
    _id: 1 
    }, { 
        $set: { 
            "name": "Bark",
            "awards.0": "Bottom Dog", 
            "awards.1": "Worst Dog"
        } 
})

Wynik:

{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }

Widzimy, że jeden dokument został zaktualizowany.

I spójrzmy na dokument.

db.pets.find().pretty()

Wynik:

{
	"_id" : 1,
	"name" : "Bark",
	"type" : "Dog",
	"awards" : [
		"Bottom Dog",
		"Worst Dog",
		"Biggest Dog"
	]
}

Filtry arrayFilters Parametr

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.updateOne(
   { scores: { $gte: 10 } },
   { $set: { "scores.$[e]" : 10 } },
   { arrayFilters: [ { "e": { $gte: 10 } } ] }
)

Wynik:

{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 } 

Zgodnie z oczekiwaniami aktualizuje to tylko jeden dokument, mimo że dwa dokumenty spełniają kryteria.

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.updateOne() metoda akceptuje również inne parametry, takie jak writeConcern , collation i hint .

Zobacz dokumentację MongoDB dla db.collections.updateOne() aby uzyskać więcej informacji.