$push (Reunir em Array)

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

$push (Reunir em Array)

$push é um acumulador que anexa o resultado da expressão de cada documento a um array durante $group, na ordem de entrada (geralmente não garantida como estável). Ele reúne os detalhes do grupo em um único documento. Use $sort antes quando precisar de uma ordem estável.

📝 Sintaxe

{ $group: { _id: <key>, items: { $push: "$field" } } }

Retorno：Matriz de todos os resultados de expressão no grupo

▶ Exemplo

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

// $push: reúne itens por cliente
db.orders.aggregate([
  { $group: { _id: '$cust_id', items: { $push: '$item' } } }
])

Saída：

{ "_id": "A123", "items": ["Pen", "Book"] }

📌 Notas

• A ordem acompanha a entrada e não é garantida como estável
• Um $sort anterior torna a ordem determinística
• Apare com $slice; deduplique com $addToSet

🏷️ 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