MongoDB updateMany()

No MongoDB o db.collection.updateMany() O método atualiza todos os documentos que correspondem ao filtro especificado para uma coleção.

Exemplo

Suponha que tenhamos uma coleção chamada pets que contém os seguintes documentos:

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

Podemos ver que dois documentos têm Dog como seu type .

Podemos atualizar os dois documentos de uma só vez assim:

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

Resultado:

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

Isso nos mostra que dois documentos corresponderam e dois foram atualizados.

Podemos conferir a coleção:

db.pets.find()

Resultado:

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

Upsert

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

Quando upsert: true , todos os documentos que corresponderem aos critérios do filtro serão atualizados, 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.updateMany( 
    { name: "Bubbles" },
    { $set: { type: "Fish" } },
    { upsert: true }
    )

Resultado:

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

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

Documentos incorporados

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

Suponha que inserimos os seguintes documentos:

db.pets.insertMany([
    {
        "_id" : 1,
        "name" : "Wag",
        "type" : "Dog",
        "specs" : {
            "height" : 400,
            "weight" : 15,
            "color" : "white"
        }
    },  
    {
        "_id" : 2,
        "name" : "Bark",
        "type" : "Dog",
        "specs" : {
            "height" : 200,
            "weight" : 12,
            "color" : "white"
        }
    }
])

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

db.pets.updateMany({ 
    type: "Dog" 
    }, { 
        $set: { 
            "specs.color": "brown",
            "specs.gooddog": false
        } 
})

Resultado:

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

Assim, podemos ver que ambos os documentos foram atualizados.

Vamos verificar o documento.

db.pets.find({
    type: "Dog"
    }).pretty()

Resultado:

{
	"_id" : 1,
	"name" : "Wag",
	"type" : "Dog",
	"specs" : {
		"height" : 400,
		"weight" : 15,
		"color" : "brown",
		"gooddog" : false
	}
}
{
	"_id" : 2,
	"name" : "Bark",
	"type" : "Dog",
	"specs" : {
		"height" : 200,
		"weight" : 12,
		"color" : "brown",
		"gooddog" : false
	}
}

Podemos ver que os documentos incorporados foram atualizados conforme especificado.

Matrizes

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

Suponha que tenhamos 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 ] }

Vamos atualizar dois elementos de array em todos os documentos.

db.players.updateMany({}, 
{ 
        $set: {
            "scores.0": 20, 
            "scores.1": 26
        } 
})

Resultado:

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

Podemos ver que todos os três documentos foram atualizados. Isso ocorre porque deixei os critérios de filtro em branco (usei {} para os critérios de filtro).

E vamos ao documento.

db.players.find()

Resultado:

 { "_id" : 1, "scores" : [ 20, 26, 3 ] }
 { "_id" : 2, "scores" : [ 20, 26, 18 ] }
 { "_id" : 3, "scores" : [ 20, 26, 8 ] }

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, olhando para o nosso documento anterior:

 { "_id" : 1, "scores" : [ 20, 26, 3 ] }
 { "_id" : 2, "scores" : [ 20, 26, 18 ] }
 { "_id" : 3, "scores" : [ 20, 26, 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 15).

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

Resultado:

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

Como esperado, todos os documentos atendem aos critérios e, portanto, são atualizados. No entanto, nem todos os elementos da matriz foram atualizados.

Veja como estão os documentos agora.

db.players.find()

Resultado:

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

Os únicos elementos do array que foram atualizados foram aqueles com valor acima de 15.

Mais informações

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

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