MongoDB update()

I MongoDB är db.collection.update() metoden modifierar ett eller flera befintliga dokument i en samling.

Som standard uppdaterar den bara ett enda dokument. Men om multi: true anges, uppdaterar den alla dokument som matchar frågekriterierna.

Uppdatera ett enda dokument

Anta att vi har samlingen som heter pets med följande dokument:

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

Vi kan uppdatera ett enda dokument så här:

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

Resultat:

WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })

Endast ett dokument uppdaterades. Detta bekräftas när vi frågar samlingen.

db.pets.find()

Resultat:

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

Uppdatera flera dokument

Låt oss använda originaldokumenten igen:

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

Den här gången lägger vi till multi: true till vår uppdateringsoperation för att uppdatera alla dokument som matchar frågekriterierna:

db.pets.update( 
    { type: "Dog" },
    { $set: { type: "Cow" } },
    { multi: true }
    )

Resultat:

WriteResult({ "nMatched" : 2, "nUpserted" : 0, "nModified" : 2 }) 

Så två dokument matchades och uppdaterades denna gång.

Låt oss titta på vår samling igen:

db.pets.find()

Resultat:

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

Som förväntat har båda dokumenten nu en type av Cow .

Upsert

db.collection.update() metoden accepterar en upsert argument som gör att du kan utföra en upsert-operation.

När upsert: true , dokumentet uppdateras om det finns en matchning med filterkriterierna, men om det inte finns någon matchning infogas ett nytt dokument.

Låt oss börja med originaldokumenten igen:

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

Exempel:

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

Resultat:

 WriteResult({
 "nMatched" : 0,
 "nUpserted" : 1,
 "nModified" : 0,
 "_id" : ObjectId("5fe2c925d9914101694102e1")
 }) 

I det här fallet fanns det inga matchningar, så ett dokument rubbades.

Låt oss kolla in samlingen.

db.pets.find()

Resultat:

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

Inbäddade dokument

Du kan också använda db.collection.update() för att uppdatera inbäddade dokument.

Anta att vi har följande dokument:

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

Vi kan använda följande kod för att uppdatera det inbäddade dokumentet.

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

Resultat:

WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) 

Så vi kan se att ett dokument matchades och modifierades.

Låt oss kontrollera dokumentet.

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

Resultat:

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

Vi kan se att det inbäddade dokumentet uppdaterades som specificerat.

Arrayer

Låt oss använda db.collection.update() för att uppdatera en array.

Anta att vi har följande dokument:

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

Låt oss uppdatera två av arrayelementen och hundens namn.

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

Resultat:

WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) 

Vi kan se att ett dokument matchades och modifierades.

Och titta nu på dokumentet.

db.pets.find().pretty()

Resultat:

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

ArrayFilters-parametern

Du kan också använda arrayFilters parametern och den positionella $ operatorn för att avgöra vilka arrayelement som ska uppdateras.

Anta till exempel att vi har en samling som heter players med följande dokument:

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

Vi skulle kunna köra följande fråga för att bara uppdatera de arrayelement som har ett värde som är högre än ett visst belopp (i det här fallet 10).

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

Resultat:

WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) 

Som väntat uppdaterar detta bara ett dokument, även om två dokument matchar kriterierna (eftersom vi inte angav multi: true ).

Så här ser dokumenten ut nu.

db.players.find()

Resultat:

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

Dokument 2 hade två arrayelement uppdaterade, eftersom dessa element matchade kriterierna.

Mer information

db.collection.update() Metoden accepterar även andra parametrar, såsom writeConcern , collation och hint .

Se MongoDB-dokumentationen för db.collections.update() för mer information.