No MongoDB o
db.collection.updateOne()
O método atualiza um único documento dentro da coleção com base no filtro. 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 atualizar um documento como este:
db.pets.updateOne(
{ type: "Dog" },
{ $set: { type: "Cow" } }
)
Resultado:
{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }
Isso atualizou apenas um documento, embora dois documentos correspondam aos critérios do filtro (os critérios sendo
type: "Dog"
). Podemos verificar os resultados assim:
db.pets.find()
Resultado:
{ "_id" : 1, "name" : "Wag", "type" : "Cow" } { "_id" : 2, "name" : "Bark", "type" : "Dog" } { "_id" : 3, "name" : "Meow", "type" : "Cat" }
O primeiro documento agora tem um
type
de Cow
em vez de Dog
, mas o segundo documento não foi afetado, embora também atendesse aos critérios de filtragem. Upsert
O
db.collection.updateOne()
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.updateOne(
{ name: "Bubbles" },
{ $set: { type: "Fish" } },
{ upsert: true }
)
Resultado:
{ "acknowledged" : true, "matchedCount" : 0, "modifiedCount" : 0, "upsertedId" : ObjectId("5fe1e94dd991410169410199") }
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("5fe1e94dd991410169410199"), "name" : "Bubbles", "type" : "Fish" }
Documentos incorporados
Você também pode usar
db.collection.updateOne()
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.updateOne({
_id: 1
}, {
$set: {
"specs.weight": 20,
"specs.color": "blue"
}
})
Resultado:
{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }
Assim, podemos ver que um documento foi atualizado.
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.updateOne()
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.updateOne({
_id: 1
}, {
$set: {
"name": "Bark",
"awards.0": "Bottom Dog",
"awards.1": "Worst Dog"
}
})
Resultado:
{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }
Podemos ver que um documento foi atualizado.
E vamos ao documento.
db.pets.find().pretty()
Resultado:
{ "_id" : 1, "name" : "Bark", "type" : "Dog", "awards" : [ "Bottom Dog", "Worst Dog", "Biggest Dog" ] }
Os arrayFilters
Parâmetro
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.updateOne(
{ scores: { $gte: 10 } },
{ $set: { "scores.$[e]" : 10 } },
{ arrayFilters: [ { "e": { $gte: 10 } } ] }
)
Resultado:
{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }
Como esperado, isso atualiza apenas um documento, mesmo que dois documentos correspondam aos critérios.
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.updateOne()
também aceita outros parâmetros, como writeConcern
, collation
e hint
. Veja a documentação do MongoDB para
db.collections.updateOne()
Para maiores informações.