$set (Definir Campos)

Última atualização: 2026-10-09

$set (Definir Campos)

$set é um alias de $addFields: ele adiciona ou sobrescreve campos em cada documento mantendo todo o resto. Use-o no meio do pipeline para anexar valores calculados, constantes ou resultados de expressões. Introduzido no MongoDB 3.4, é totalmente intercambiável com $addFields; note que ele compartilha um nome com o operador de atualização $set.

📝 Sintaxe

{ $set: { <campo>: <expressão>, ... } }

⚙️ Parâmetros

Retorno：Fluxo de documentos com campos definidos

▶ Exemplo

Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):

// $set: adiciona uma constante status, converte o tipo de amount
db.orders.aggregate([
  { $set: { status: 'PENDING', amount: { $toDouble: '$amount' } } }
])

Saída：

// Campos originais mantidos; status é uma constante, amount convertido para double

📌 Notas

• $set é totalmente equivalente a $addFields
• _id e todos os campos não mencionados ficam intactos
• Você não pode referenciar campos definidos no mesmo estágio

🏷️ Tags Relacionados

💡 Casos Relacionados

📚 Tutoriais Relacionados

❓ Perguntas Frequentes

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós