/ /

$firstN (expressão)

Definição

$firstN

Retorna o número especificado de elementos desde o início de uma array.

Observação

Desambiguação

Esta página descreve $firstN quando usado como uma expressão, que retorna o número especificado de elementos desde o início de uma array.

Você também pode usar $firstN nestes outros contextos:

$firstN (accumulator), usado no agrupamento para retornar os primeiros elementos n de cada grupo.
$firstN (window function), que é usado no estágio $setWindowFields para retornar os primeiros valores n de documentos em uma janela específica.

Sintaxe

{ $firstN: { input: <expression>, n: <expression> } }

Opções

Campo	Tipo	Descrição
`input`	Expressão	A array a partir da qual retornar os primeiros elementos `n` .
`n`	Expressão	O número de elementos que `$firstN` retorna. Deve resolver para um número inteiro positivo.

Comportamento

$firstN retorna elementos na mesma ordem em que aparecem na array de entrada.
$firstN não filtra valores null na array de entrada.
Você não pode especificar um valor de n menor que 1.
Se o n especificado for maior ou igual ao número de elementos na array input, $firstN retornará a array input inteira.
Se input resolver para um valor que não seja da array, a operação de agregação será executada.

Exemplo

Os exemplos nesta página usam dados do conjunto de dados sample_mflix. Para obter detalhes sobre como carregar esse conjunto de dados em sua implantação autogerenciada do MongoDB , consulte Carregar o conjunto de dados de amostra. Se você fez modificações nos bancos de dados de amostra, talvez seja necessário descartar e recriar os bancos de dados para executar os exemplos nesta página.

O exemplo a seguir usa o operador $firstN para retornar os três primeiros membros do elenco de cada filme. Os membros do elenco são retornados no novo campo firstThreeCast criado por $addFields.

db.movies.aggregate( [
   {
      $match: {
         title: { $in: [ "The Godfather", "Spirited Away", "The Dark Knight" ] }
      }
   },
   {
      $addFields: {
         firstThreeCast: { $firstN: { input: "$cast", n: 3 } }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         cast: 1,
         firstThreeCast: 1
      }
   },
   {
      $sort: { title: 1 }
   }
] )

[
  {
    title: 'Spirited Away',
    cast: [ 'Rumi Hiiragi', 'Miyu Irino', 'Mari Natsuki', 'Takashi Naitè' ],
    firstThreeCast: [ 'Rumi Hiiragi', 'Miyu Irino', 'Mari Natsuki' ]
  },
  {
    title: 'The Dark Knight',
    cast: [ 'Christian Bale', 'Heath Ledger', 'Aaron Eckhart', 'Michael Caine' ],
    firstThreeCast: [ 'Christian Bale', 'Heath Ledger', 'Aaron Eckhart' ]
  },
  {
    title: 'The Godfather',
    cast: [ 'Marlon Brando', 'Al Pacino', 'James Caan', 'Richard S. Castellano' ],
    firstThreeCast: [ 'Marlon Brando', 'Al Pacino', 'James Caan' ]
  }
]

O pipeline anterior:

Utiliza $match para filtrar três filmes específicos.
Usa $addFields com $firstN para criar um novo campo firstThreeCast contendo os três primeiros elementos da array cast com n: 3.
Usa $project para incluir somente os campos title, cast e firstThreeCast no resultado.
Utiliza $sort para classificar os resultados por título.

Saiba mais

Voltar

$first

$floor