/ /

$top (função de janela)

Definição

$top

Retorna o principal elemento de uma janela de acordo com a ordem de classificação especificada.

Observação

Desambiguação

Esta página descreve $top quando usado como uma função de janela. Você também pode usar $top nestes outros contextos:

$top (expression operator), que retorna o elemento superior de uma array com base em uma ordem de classificação especificada.
$top (accumulator), que retorna o principal elemento de um grupo de acordo com a ordem de classificação especificada.

Sintaxe

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $top: {
               sortBy: { <field1>: <sort order>, <field2>: <sort order> ... },
               output: <expression>
            }
         }
      }
   }
}

Campo	necessidade	Descrição
sortBy	Obrigatório	Define a ordem de classificação dos elementos dentro da janela, com sintaxe semelhante a `$sort`. Não afeta a ordem dos documentos na saída do pipeline.
saída	Obrigatório	Especifica a saída para cada elemento na janela. Pode ser qualquer expressão.

Comportamento

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

$top não filtra valores nulos.
$top 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.

Encontre o filme mais bem classificado por ano em uma janela

Este exemplo usa $top como uma função de janela para identificar o filme mais bem classificado no mesmo ano para cada documento de filme . O conjunto de dados é filtrado para incluir apenas filmes da família com classificação PG de 1980 a 1982.

db.movies.aggregate( [
   {
      $match: {
         year: { $in: [ 1980, 1981, 1982 ] },
         "imdb.rating": { $exists: true, $ne: null },
         genres: "Family",
         rated: "PG"
      }
   },
   {
      $setWindowFields: {
         partitionBy: "$year",
         output: {
            highestRatedInYear: {
               $top: {
                  output: { title: "$title", rating: "$imdb.rating" },
                  sortBy: { "imdb.rating": -1 }
               },
               window: {
                  documents: [ "unbounded", "unbounded" ]
               }
            }
         }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         year: 1,
         rating: "$imdb.rating",
         highestRatedInYear: 1
      }
   },
   {
      $limit: 10
   }
] )

[
  {
    title: 'My Bodyguard',
    year: 1980,
    highestRatedInYear: { title: 'My Bodyguard', rating: 7 },
    rating: 7
  },
  {
    title: 'Popeye',
    year: 1980,
    highestRatedInYear: { title: 'My Bodyguard', rating: 7 },
    rating: 5.2
  },
  {
    title: 'The Watcher in the Woods',
    year: 1980,
    highestRatedInYear: { title: 'My Bodyguard', rating: 7 },
    rating: 6.5
  },
  {
    title: 'Clash of the Titans',
    year: 1981,
    highestRatedInYear: { title: 'Clash of the Titans', rating: 6.9 },
    rating: 6.9
  },
  {
    title: 'Going Ape!',
    year: 1981,
    highestRatedInYear: { title: 'Clash of the Titans', rating: 6.9 },
    rating: 3.6
  },
  {
    title: 'Night Crossing',
    year: 1982,
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 6.4
  },
  {
    year: 1982,
    title: 'Annie',
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 6.5
  },
  {
    title: 'Author! Author!',
    year: 1982,
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 6.1
  },
  {
    title: 'The Dark Crystal',
    year: 1982,
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 7.2
  },
  {
    year: 1982,
    title: 'E.T. the Extra-Terrestrial',
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 7.9
  }
]

Neste exemplo:

O estágio $match filtra filmes de família com classificação PG de 1980 a 1982 para produzir um conjunto de resultados pequeno e focado.
$setWindowFields divide os documentos por year.
A janela se estende de unbounded a unbounded, o que significa que $top considera todos os documentos na partição ao determinar o filme mais bem classificado.
$top retorna o filme mais bem classificado em cada partição como um documento incorporado contendo os campos title e rating.
$project inclui apenas os campos title, year, rating e highestRatedInYear no resultado.
$limit limita a saída a 10 documentos.

Essa abordagem preserva todos os documentos individuais de filmes e inclui uma referência ao melhor desempenho de cada ano.

Voltar

$sum

$topN