$facet (Agregação Multifacetada)

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

$facet (Agregação Multifacetada)

$facet executa vários sub-pipelines em paralelo dentro de um único estágio, cada um processando os mesmos documentos de entrada, e mescla os resultados como campos: { nome: [ resultados ] }. Obtenha estatísticas resumidas, listas de detalhes e top-N em uma única requisição em vez de múltiplas idas e vindas. Os sub-pipelines são independentes.

📝 Sintaxe

{ $facet: { <outputField1>: [ <sub-pipeline1> ], <outputField2>: [ <sub-pipeline2> ] } }

⚙️ Parâmetros

Retorno：Um único documento cujos campos contêm a matriz de resultados de cada subpipeline

▶ Exemplo

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

// $facet: divisão por status mais top 5 por valor
db.orders.aggregate([
  { $facet: {
    byStatus: [{ $group: { _id: '$status', n: { $sum: 1 } } }],
    top5: [{ $sort: { amount: -1 } }, { $limit: 5 }]
  } }
])

Saída：

{ "byStatus": [ { "_id": "A", "n": 20 } ], "top5": [ { ... } ] }

📌 Notas

• Os sub-pipelines não podem conter estágios como $out, $merge ou $facet
• Os sub-pipelines são independentes; cada um vê a entrada completa
• A saída é um único documento com um array por nome de sub-pipeline

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