No MongoDB, você pode renomear um campo ao atualizar documentos em uma coleção.
Para renomear um campo, chame o método
$rename
operador com o nome atual do campo e o novo nome. Isso renomeia o campo em todos os documentos correspondentes que tenham um campo com esse nome. Exemplo
Suponha que tenhamos uma coleção chamada
employees
com os seguintes documentos:{ "_id" : 1, "name" : "Sandy", "salary" : 55000 } { "_id" : 2, "name" : "Sarah", "salary" : 128000 } { "_id" : 3, "name" : "Fritz", "salary" : 25000 } { "_id" : 4, "name" : "Chris", "salary" : 45000 } { "_id" : 5, "name" : "Beck", "salary" : 82000 }
E suponha que queremos renomear o
name
campo para employee
. Poderíamos fazer isso:
db.employees.updateMany(
{ },
{ $rename: { "name": "employee" } }
)
Saída:
{ "acknowledged" : true, "matchedCount" : 5, "modifiedCount" : 5 }
Agora, quando usamos o
find()
para retornar os documentos da coleção, vemos o seguinte resultado:db.employees.find()
Resultado:
{ "_id" : 1, "salary" : 55000, "employee" : "Sandy" } { "_id" : 2, "salary" : 128000, "employee" : "Sarah" } { "_id" : 3, "salary" : 25000, "employee" : "Fritz" } { "_id" : 4, "salary" : 45000, "employee" : "Chris" } { "_id" : 5, "salary" : 82000, "employee" : "Beck" }
Renomear vários campos
Você pode renomear vários campos separando-os com uma vírgula.
Exemplo:
db.employees.updateMany(
{ },
{ $rename: { "employee": "e", "salary": "s" } }
)
Saída:
{ "acknowledged" : true, "matchedCount" : 5, "modifiedCount" : 5 }
E veja como está a coleção agora:
{ "_id" : 1, "e" : "Sandy", "s" : 55000 } { "_id" : 2, "e" : "Sarah", "s" : 128000 } { "_id" : 3, "e" : "Fritz", "s" : 25000 } { "_id" : 4, "e" : "Chris", "s" : 45000 } { "_id" : 5, "e" : "Beck", "s" : 82000 }
Documentos incorporados
Você pode usar a notação de ponto para atualizar os nomes dos campos em documentos incorporados.
Exemplo de documento:
db.pets.findOne()
Resultado:
{ "_id" : 1, "name" : "Wag", "details" : { "type" : "Dog", "weight" : 20, "awards" : { "Florida Dog Awards" : "Top Dog", "New York Marathon" : "Fastest Dog", "Sumo 2020" : "Biggest Dog" } } }
Vamos atualizar alguns dos campos no documento incorporado:
db.pets.updateMany(
{ },
{ $rename: {
"details.type": "details.t",
"details.weight": "details.w",
"details.awards": "details.a"
}
}
)
Agora, quando verificamos o documento, vemos o seguinte:
db.pets.findOne()
Resultado:
{ "_id" : 1, "name" : "Wag", "details" : { "a" : { "Florida Dog Awards" : "Top Dog", "New York Marathon" : "Fastest Dog", "Sumo 2020" : "Biggest Dog" }, "t" : "Dog", "w" : 20 } }
Também podemos atualizar os nomes dos campos dos documentos incorporados nos documentos incorporados:
db.pets.updateMany(
{ },
{ $rename: {
"details.a.Florida Dog Awards": "details.a.fda",
"details.a.New York Marathon": "details.a.nym",
"details.a.Sumo 2020": "details.a.s2020"
}
}
)
E vamos verificar o documento novamente:
db.pets.findOne()
Resultado:
{ "_id" : 1, "name" : "Wag", "details" : { "a" : { "fda" : "Top Dog", "nym" : "Fastest Dog", "s2020" : "Biggest Dog" }, "t" : "Dog", "w" : 20 } }