MongoDB updateOne()

В MongoDB db.collection.updateOne() метод актуализира единичен документ в колекцията въз основа на филтъра.

Пример

Да предположим, че имаме колекция, наречена pets който съдържа следните документи:

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

Можем да актуализираме един документ по следния начин:

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

Резултат:

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

Това актуализира само един документ, въпреки че два документа отговарят на критериите за филтриране (критериите са type: "Dog" ).

Можем да проверим резултатите по следния начин:

db.pets.find()

Резултат:

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

Първият документ вече има type на Cow вместо Dog , но вторият документ не беше засегнат, въпреки че също отговаряше на критериите за филтриране.

Нагоре

db.collection.updateOne() методът приема upsert аргумент, който ви позволява да извършите операция upsert.

Когато upsert: true , документът се актуализира, ако има съответствие с критериите за филтриране, но ако няма съвпадение, се вмъква нов документ.

Нека започнем отново с оригиналните документи:

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

Пример:

db.pets.updateOne( 
    { name: "Bubbles" },
    { $set: { type: "Fish" } },
    { upsert: true }
    )

Резултат:

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

В този случай нямаше съвпадения, така че документът беше въведен.

Нека проверим колекцията.

db.pets.find()

Резултат:

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

Вградени документи

Можете също да използвате db.collection.updateOne() за да актуализирате вградените документи.

Да предположим, че имаме следния документ:

{
	"_id" : 1,
	"name" : "Wag",
	"type" : "Dog",
	"specs" : {
		"height" : 400,
		"weight" : 15,
		"color" : "brown"
	}
}

Можем да използваме следния код, за да актуализираме вградения документ.

db.pets.updateOne({ 
    _id: 1 
    }, { 
        $set: { 
            "specs.weight": 20, 
            "specs.color": "blue"
        } 
})

Резултат:

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

Така можем да видим, че един документ е актуализиран.

Нека проверим документа.

db.pets.find({
    _id: 1
    }).pretty()

Резултат:

{
	"_id" : 1,
	"name" : "Wag",
	"type" : "Dog",
	"specs" : {
		"height" : 400,
		"weight" : 20,
		"color" : "blue"
	}
}

Можем да видим, че вграденият документ е актуализиран, както е посочено.

Масиви

Нека използваме db.collection.updateOne() за да актуализирате масив.

Да предположим, че имаме следния документ:

{
	"_id" : 1,
	"name" : "Wag",
	"type" : "Dog",
	"awards" : [
		"Top Dog",
		"Best Dog",
		"Biggest Dog"
	]
}

Нека актуализираме два от елементите на масива и името на кучето.

db.pets.updateOne({ 
    _id: 1 
    }, { 
        $set: { 
            "name": "Bark",
            "awards.0": "Bottom Dog", 
            "awards.1": "Worst Dog"
        } 
})

Резултат:

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

Виждаме, че един документ е актуализиран.

И нека разгледаме документа.

db.pets.find().pretty()

Резултат:

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

arrayFilters Параметър

Можете също да използвате arrayFilters параметър и позиционния $ оператор, за да определи кои елементи на масива да актуализира.

Например, да предположим, че имаме колекция, наречена players със следните документи:

{ "_id" : 1, "scores" : [ 1, 5, 3 ] }
{ "_id" : 2, "scores" : [ 8, 17, 18 ] }
{ "_id" : 3, "scores" : [ 15, 11, 8 ] }

Бихме могли да изпълним следната заявка, за да актуализираме само онези елементи на масива, които имат стойност, по-висока от определено количество (в този случай 10).

db.players.updateOne(
   { scores: { $gte: 10 } },
   { $set: { "scores.$[e]" : 10 } },
   { arrayFilters: [ { "e": { $gte: 10 } } ] }
)

Резултат:

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

Както се очаква, това актуализира само един документ, въпреки че два документа отговарят на критериите.

Ето как изглеждат документите сега.

db.players.find()

Резултат:

{ "_id" : 1, "scores" : [ 1, 5, 3 ] }
{ "_id" : 2, "scores" : [ 8, 10, 10 ] }
{ "_id" : 3, "scores" : [ 15, 11, 8 ] }

В документ 2 бяха актуализирани два елемента на масива, тъй като тези елементи отговаряха на критериите.

Повече информация

db.collection.updateOne() Методът приема и други параметри, като writeConcern , collation и hint .

Вижте документацията на MongoDB за db.collections.updateOne() за повече информация.