/ /

$topN (função de janela)

Definição

$topN

Retorna os principais elementos n em uma janela específica, de acordo com a ordem de classificação especificada.

Observação

Outros usos de $topN

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

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

$topN (accumulator), que retorna os principais elementos n dentro de um grupo de acordo com a ordem de classificação especificada.
$topN (expression), que retorna os principais elementos n de uma array.

Sintaxe

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

Opções

Campo	necessidade	Descrição
`n`	Obrigatório	Número de resultados a retornar. Deve resultar em um valor integral positivo. Se a janela tiver menos de `n` elementos, `$topN` retornará todos os elementos na janela.
`output`	Obrigatório	Determina a saída para cada documento na janela. Pode ser qualquer expressã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.

Comportamento

Valores nulos e ausentes

$topN não filtra valores nulos.
$topN 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 os três filmes mais bem avaliados em uma janela

Este exemplo usa $topN em $setWindowFields para retornar cada filme com os três filmes mais bem avaliados lançados no mesmo ano.

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

[
  {
    imdb: { rating: 8.9 },
    year: 1999,
    title: 'Fight Club',
    topThreeRatedInYear: [
      { rating: 8.9, title: 'Fight Club' },
      { rating: 8.7, title: 'Eddie Izzard: Dress to Kill' },
      { rating: 8.7, title: 'The Matrix' }
    ]
  },
  {
    imdb: { rating: 8.7 },
    year: 1999,
    title: 'The Matrix',
    topThreeRatedInYear: [
      { rating: 8.9, title: 'Fight Club' },
      { rating: 8.7, title: 'Eddie Izzard: Dress to Kill' },
      { rating: 8.7, title: 'The Matrix' }
    ]
  },
  {
    title: 'Eddie Izzard: Dress to Kill',
    year: 1999,
    imdb: { rating: 8.7 },
    topThreeRatedInYear: [
      { rating: 8.9, title: 'Fight Club' },
      { rating: 8.7, title: 'Eddie Izzard: Dress to Kill' },
      { rating: 8.7, title: 'The Matrix' }
    ]
  },
  {
    imdb: { rating: 8.5 },
    year: 1999,
    title: 'The Green Mile',
    topThreeRatedInYear: [
      { rating: 8.9, title: 'Fight Club' },
      { rating: 8.7, title: 'Eddie Izzard: Dress to Kill' },
      { rating: 8.7, title: 'The Matrix' }
    ]
  },
  {
    title: 'Band of Brothers',
    year: 2001,
    imdb: { rating: 9.6 },
    topThreeRatedInYear: [
      { rating: 9.6, title: 'Band of Brothers' },
      { rating: 9.2, title: 'The Blue Planet' },
      {
        rating: 8.8,
        title: 'The Lord of the Rings: The Fellowship of the Ring'
      }
    ]
  },
  {
    title: 'The Blue Planet',
    year: 2001,
    imdb: { rating: 9.2 },
    topThreeRatedInYear: [
      { rating: 9.6, title: 'Band of Brothers' },
      { rating: 9.2, title: 'The Blue Planet' },
      {
        rating: 8.8,
        title: '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',
    topThreeRatedInYear: [
      { rating: 9.6, title: 'Band of Brothers' },
      { rating: 9.2, title: 'The Blue Planet' },
      {
        rating: 8.8,
        title: 'The Lord of the Rings: The Fellowship of the Ring'
      }
    ]
  },
  {
    imdb: { rating: 8.6 },
    year: 2001,
    title: 'Spirited Away',
    topThreeRatedInYear: [
      { rating: 9.6, title: 'Band of Brothers' },
      { rating: 9.2, title: 'The Blue Planet' },
      {
        rating: 8.8,
        title: 'The Lord of the Rings: The Fellowship of the Ring'
      }
    ]
  },
  {
    title: 'Promises',
    year: 2001,
    imdb: { rating: 8.5 },
    topThreeRatedInYear: [
      { rating: 9.6, title: 'Band of Brothers' },
      { rating: 9.2, title: 'The Blue Planet' },
      {
        rating: 8.8,
        title: 'The Lord of the Rings: The Fellowship of the Ring'
      }
    ]
  }
]

No exemplo anterior:

$match filtros para filmes lançados em 1999 ou 2001 com uma classificação do IMDb de pelo menos 8.5.
$setWindowFields divide os documentos por year.
window: { documents: [ "unbounded", "unbounded" ] } abrange a partição do ano inteiro, portanto, $topN considera todos os documentos do ano ao determinar os três filmes mais bem avaliados.
$topN usa sortBy: { "imdb.rating": -1, title: 1 } para classificar filmes por pontuação IMDb e usa title como desempate. Cada documento no mesmo ano recebe o mesmo valor de topThreeRatedInYear.
$project remove campos desnecessários para destacar o resultado da função da janela.
$sort classifica a saída por ano crescente e classificação decrescente.

Voltar

$top

Sessões do servidor