/ /

$first (função de janela)

Definição

$first

Retorna o valor de uma expressão para o primeiro documento em uma janela.

Observação

Desambiguação

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

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

$first (accumulator), usado no agrupamento para retornar o primeiro valor de cada grupo.
$first (expression), que retorna o primeiro elemento de uma array.

Sintaxe

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $first: <expression>
         }
      }
   }
}

Comportamento

A função da janela $first tem os seguintes comportamentos para valores nulos e ausentes:

$first converte valores de campo ausentes em null.
$first retorna null para janelas vazias.

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 identificar o filme com maior classificação em cada ano. Cada documento inclui um campo mostrando o título do filme mais bem avaliado lançado naquele ano:

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

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

No pipeline anterior:

$match filtros para filmes de 1999-2001 com uma classificação IMDb de 8.5 ou superior.
$setWindowFields divide os filmes por year e os classifica por imdb.rating em ordem decrescente. O estágio usa $first com uma janela definida como documents: [ "unbounded", "unbounded" ] para retornar o título do filme com melhor classificação na partição de cada ano.
$project inclui apenas title, year, imdb.rating e topRatedMovieInYear na saída.
$sort classifica os resultados por ano e classificação.

Voltar

$count

$firstN