MongoDB updateOne()

V MongoDB db.collection.updateOne() metoda aktualizuje jeden dokument v rámci kolekce na základě filtru.

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

Jeden dokument můžeme aktualizovat takto:

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

Výsledek:

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

To aktualizovalo pouze jeden dokument, přestože dva dokumenty splňují kritéria filtru (kritéria jsou type: "Dog" ).

Výsledky můžeme zkontrolovat takto:

db.pets.find()

Výsledek:

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

První dokument má nyní type z Cow místo Dog , ale druhý dokument nebyl ovlivněn, i když také odpovídal kritériím filtrování.

Upsert

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

Výsledek:

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

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

Vložené dokumenty

Můžete také použít db.collection.updateOne() 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.updateOne({ 
    _id: 1 
    }, { 
        $set: { 
            "specs.weight": 20, 
            "specs.color": "blue"
        } 
})

Výsledek:

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

Takže vidíme, že jeden dokument byl aktualizován.

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

Výsledek:

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

Vidíme, že jeden dokument byl aktualizován.

A podívejme se na dokument.

db.pets.find().pretty()

Výsledek:

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

arrayFilters Parametr

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

Výsledek:

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

Podle očekávání se aktualizuje pouze jeden dokument, i když dva dokumenty odpovídají kritériím.

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

Dokument 2 měl aktualizovány dva prvky pole, protože tyto prvky odpovídaly kritériím.

Další informace

db.collection.updateOne() metoda také přijímá další parametry, jako je writeConcern , collation a hint .

Viz dokumentaci MongoDB pro db.collections.updateOne() pro více informací.