Atualização do MongoDB()

No MongoDB o db.collection.update() O método modifica um documento ou documentos existentes em uma coleção.

Por padrão, ele atualiza apenas um único documento. Mas se multi: true for especificado, ele atualizará todos os documentos que correspondem aos critérios de consulta.

Atualizar um único documento

Suponha que temos a coleção chamada pets com os seguintes documentos:

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

Podemos atualizar um único documento como este:

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

Resultado:

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

Apenas um documento foi atualizado. Isso é confirmado quando consultamos a coleção.

db.pets.find()

Resultado:

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

Atualizar vários documentos

Vamos usar os documentos originais novamente:

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

Desta vez, adicionaremos multi: true à nossa operação de atualização para atualizar todos os documentos que correspondem aos critérios de consulta:

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

Resultado:

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

Assim, dois documentos foram combinados e atualizados desta vez.

Vejamos novamente nossa coleção:

db.pets.find()

Resultado:

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

Como esperado, ambos os documentos agora têm um type de Cow .

Upsert

O db.collection.update() O método aceita um upsert argumento que permite executar uma operação de upsert.

Quando upsert: true , o documento é atualizado se houver correspondência com os critérios do filtro, mas se não houver correspondência, um novo documento será inserido.

Vamos começar com os documentos originais novamente:

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

Exemplo:

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

Resultado:

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

Nesse caso, não houve correspondências, então um documento foi upserted.

Vamos conferir a coleção.

db.pets.find()

Resultado:

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

Documentos incorporados

Você também pode usar db.collection.update() para atualizar documentos incorporados.

Suponha que temos o seguinte documento:

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

Podemos usar o código a seguir para atualizar o documento incorporado.

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

Resultado:

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

Assim, podemos ver que um documento foi correspondido e modificado.

Vamos verificar o documento.

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

Resultado:

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

Podemos ver que o documento incorporado foi atualizado conforme especificado.

Matrizes

Vamos usar db.collection.update() para atualizar uma matriz.

Suponha que temos o seguinte documento:

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

Vamos atualizar dois dos elementos do array e o nome do cachorro.

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

Resultado:

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

Podemos ver que um documento foi correspondido e modificado.

E agora olhe para o documento.

db.pets.find().pretty()

Resultado:

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

O parâmetro arrayFilters

Você também pode usar os arrayFilters parâmetro e o posicional $ operador para determinar quais elementos da matriz devem ser atualizados.

Por exemplo, suponha que temos uma coleção chamada players com os seguintes documentos:

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

Poderíamos executar a seguinte consulta para atualizar apenas os elementos do array que possuem um valor maior que um determinado valor (neste caso 10).

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

Resultado:

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

Como esperado, isso atualiza apenas um documento, mesmo que dois documentos correspondam aos critérios (porque não especificamos multi: true ).

Veja como estão os documentos agora.

db.players.find()

Resultado:

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

O Documento 2 teve dois elementos do array atualizados, porque esses elementos correspondiam aos critérios.

Mais informações

O db.collection.update() também aceita outros parâmetros, como writeConcern , collation e hint .

Veja a documentação do MongoDB para db.collections.update() Para maiores informações.