$firstN (Acumulador de Primeiros N)

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

$firstN (Acumulador de Primeiros N)

$firstN é um acumulador que retorna um array dos valores de um campo dos primeiros N documentos de um grupo (na ordem de entrada), disponível desde o MongoDB 5.2. Ele se relaciona com $first como $topN se relaciona com $top, mas segue a ordem de entrada em vez de uma regra de ordenação. n pode ser constante ou expressão.

📝 Sintaxe

{ $group: { _id: <key>, firstN: { $firstN: { input: <expression>, n: <number> } } } }

Retorno：Matriz de valores de expressão dos primeiros N documentos do grupo

▶ Exemplo

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

// $firstN: preços dos 3 primeiros registros por item
db.sales.aggregate([
  { $sort: { date: 1 } },
  { $group: { _id: '$item', first3: { $firstN: { input: '$price', n: 3 } } } }
])

Saída：

{ "_id": "Pen", "first3": [20, 25, 30] }

📌 Notas

• Exige MongoDB 5.2 ou posterior
• A ordem depende da entrada, então use $sort antes para dar sentido
• n aceita uma expressão para contagens dinâmicas

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