/ /

$firstN (função de janela)

Definição

$firstN

Retorna uma array contendo os primeiros elementos n dentro de uma janela.

Observação

Desambiguação

Esta página descreve $firstN quando usado como uma função de janela.

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

$firstN (accumulator), usado no agrupamento para retornar os primeiros elementos n de cada grupo.
$firstN (expression), que retorna o número especificado de elementos desde o início de uma array.

Sintaxe

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $firstN: {
               input: <expression>,
               n: <expression>
            }
         }
      }
   }
}

Opções

Campo	Tipo	Descrição
`input`	Expressão	A expressão `input` é avaliada sobre cada documento na janela, e os primeiros resultados `n` são preservados.
`n`	Expressão	O número de elementos que `$firstN` retorna da janela. Deve resolver para um número inteiro positivo. Se a janela tiver menos de `n` elementos, `$firstN` retornará todos os elementos na janela.

Comportamento

Valores nulos e ausentes

$firstN não filtra valores nulos.
$firstN converte valores ausentes em nulo.

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.

Este exemplo usa $setWindowFields para dividir filmes por year, classificá-los por imdb.rating em ordem decrescente e retornar os três primeiros filmes de cada ano. Cada filme também inclui um campo que mostra os três títulos de filmes mais bem avaliados lançados naquele ano:

db.movies.aggregate( [
   {
      $match: {
         year: { $in: [ 1999, 2000, 2001 ] },
         "imdb.rating": { $gte: 8.5 }
      }
   },
   {
      $setWindowFields: {
         partitionBy: "$year",
         sortBy: { "imdb.rating": -1 },
         output: {
            topThreeMoviesInYear: {
               $firstN: {
                  input: "$title",
                  n: 3
               },
               window: {
                  documents: [ "unbounded", "unbounded" ]
               }
            }
         }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         year: 1,
         "imdb.rating": 1,
         topThreeMoviesInYear: 1
      }
   },
   {
      $sort: { year: 1, "imdb.rating": -1 }
   }
] )

[
  {
    imdb: { rating: 8.9 },
    year: 1999,
    title: 'Fight Club',
    topThreeMoviesInYear: [ 'Fight Club', 'The Matrix', 'Eddie Izzard: Dress to Kill' ]
  },
  {
    imdb: { rating: 8.7 },
    year: 1999,
    title: 'The Matrix',
    topThreeMoviesInYear: [ 'Fight Club', 'The Matrix', 'Eddie Izzard: Dress to Kill' ]
  },
  {
    title: 'Eddie Izzard: Dress to Kill',
    year: 1999,
    imdb: { rating: 8.7 },
    topThreeMoviesInYear: [ 'Fight Club', 'The Matrix', 'Eddie Izzard: Dress to Kill' ]
  },
  {
    imdb: { rating: 8.5 },
    year: 1999,
    title: 'The Green Mile',
    topThreeMoviesInYear: [ 'Fight Club', 'The Matrix', 'Eddie Izzard: Dress to Kill' ]
  },
  {
    imdb: { rating: 8.5 },
    year: 2000,
    title: 'Gladiator',
    topThreeMoviesInYear: [ 'Gladiator', 'Memento', 'Hera Pheri' ]
  },
  {
    imdb: { rating: 8.5 },
    year: 2000,
    title: 'Memento',
    topThreeMoviesInYear: [ 'Gladiator', 'Memento', 'Hera Pheri' ]
  },
  {
    title: 'Hera Pheri',
    year: 2000,
    imdb: { rating: 8.5 },
    topThreeMoviesInYear: [ 'Gladiator', 'Memento', 'Hera Pheri' ]
  },
  {
    title: "A Dog's Will",
    year: 2000,
    imdb: { rating: 8.5 },
    topThreeMoviesInYear: [ 'Gladiator', 'Memento', 'Hera Pheri' ]
  },
  {
    title: 'Band of Brothers',
    year: 2001,
    imdb: { rating: 9.6 },
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  },
  {
    title: 'The Blue Planet',
    year: 2001,
    imdb: { rating: 9.2 },
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  },
  {
    imdb: { rating: 8.8 },
    year: 2001,
    title: 'The Lord of the Rings: The Fellowship of the Ring',
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  },
  {
    imdb: { rating: 8.6 },
    year: 2001,
    title: 'Spirited Away',
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  },
  {
    title: 'Promises',
    year: 2001,
    imdb: { rating: 8.5 },
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  }
]

O pipeline anterior:

Usa o estágio $match para filtrar os resultados para filmes lançados entre os anos 1999 e 2001 com uma classificação do IMDb de 8.5 ou superior.
Usa $setWindowFields para dividir filmes por year e classificá-los por imdb.rating em ordem decrescente. O estágio usa $firstN com n: 3 para criar topThreeMoviesInYear a partir de uma janela definida como documents: [ "unbounded", "unbounded" ].
Usa $project para incluir somente os campos title, year, imdb.rating e topThreeMoviesInYear no resultado.
Utiliza $sort para classificar os resultados por ano e classificação.

Voltar

$first

$last