$topN (operador acumulador )

Definição

$topN

Retorna uma aggregation dos principais n elementos dentro de um grupo, de acordo com a ordem de classificação especificada. Se o grupo tiver menos de n elementos, $topN retornará todos os elementos no grupo.

Observação

Outros usos de $topN

Esta página descreve $topN quando usado como um acumulador. Acumuladores retornam um valor agregado em um grupo de documentos de entrada.

Você também pode usar o $topN (window function), que retorna os n principais elementos de documentos em uma janela específica de acordo com a ordem de classificação especificada.

Sintaxe

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

Campo	Tipo	Descrição
`n`	Expressão	Determina o número máximo de resultados retornados por grupo. `n` deve ser avaliado como um número inteiro positivo.
`sortBy`	Documento	Especifica a ordem dos resultados, com sintaxe semelhante a `$sort`. Não afeta a ordem dos documentos na saída do pipeline.
`output`	Expressão	Especifica a saída para cada elemento no grupo. Pode ser qualquer expressão.

Comportamento

Valores nulos e ausentes

$topN não filtra valores nulos.
$topN converte valores ausentes em nulo que são preservados na saída.

db.aggregate( [   {      $documents: [         { playerId: "PlayerA", gameId: "G1", score: 1 },         { playerId: "PlayerB", gameId: "G1", score: 2 },         { playerId: "PlayerC", gameId: "G1", score: 3 },         { playerId: "PlayerD", gameId: "G1"},         { playerId: "PlayerE", gameId: "G1", score: null }      ]   },   {      $group:      {         _id: "$gameId",         playerId:            {               $topN:                  {                     output: [ "$playerId", "$score" ],                     sortBy: { "score": 1 },                     n: 3                  }            }      }   }] )

Neste exemplo:

$documents cria os documentos literais que contêm as pontuações dos jogadores.
$group agrupa os documentos por gameId. Este exemplo tem apenas um gameId, G1.
PlayerD tem uma pontuação ausente e PlayerE tem um nulo score. Esses valores são considerados nulos.
Os campos playerId e score são especificados como output : ["$playerId"," $score"] e retornados como valores de array.
Devido a sortBy: { "score" : 1 }, os valores nulos são ordenados para a frente do array playerId retornado.

[   {      _id: 'G1',      playerId: [ [ 'PlayerD', null ], [ 'PlayerE', null ], [ 'PlayerA', 1 ] ]   }]

Ordenação de classificação do tipo de dados BSON

Ao classificar diferentes tipos, a ordem dos tipos de dados BSON é usada para determinar a ordem. Como exemplo, considere uma collection cujos valores consistem em strings e números.

Em uma classificação crescente, os valores de string são classificados após valores numéricos.
Em uma classificação decrescente, os valores de string são classificados antes dos valores numéricos.

db.aggregate( [   {      $documents: [         { playerId: "PlayerA", gameId: "G1", score: 1 },         { playerId: "PlayerB", gameId: "G1", score: "2" },         { playerId: "PlayerC", gameId: "G1", score: "" }      ]   },   {      $group:         {            _id: "$gameId",            playerId: {               $topN:               {                  output: ["$playerId","$score"],                  sortBy: {"score": -1},                  n: 3               }            }         }   }] )

Neste exemplo:

PlayerA tem uma pontuação inteira.
PlayerB tem uma pontuação de string "2" .
PlayerC tem uma pontuação de string vazia.

Como a classificação está em { "score" : -1 } decrescente, os valores literais da string são classificados antes da pontuação numérica PlayerA:

[   {      _id: "G1",      playerId: [ [ "PlayerB", "2" ], [ "PlayerC", "" ], [ "PlayerA", 1 ] ]   }]

Exemplos

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

Encontrar os três filmes mais bem avaliados em um único gênero

Você pode usar o acumulador $topN para encontrar os três filmes mais bem avaliados no gênero Short.

db.movies.aggregate( [   {      $match: {         genres: "Short",         "imdb.rating": { $gt: 0 }      }   },   {      $group: {         _id: "Short",         topRatedMovies: {            $topN: {               output: [ "$title", "$imdb.rating" ],               sortBy: { "imdb.rating": -1, title: 1 },               n: 3            }         }      }   }] )

[  {    _id: 'Short',    topRatedMovies: [      [ 'Rabbit and Deer', 8.7 ],      [ 'Assume the Position with Mr. Wuhl', 8.6 ],      [ 'Hole', 8.6 ]    ]  }]

O exemplo de pipeline:

Usa $match para restringir a entrada a Short filmes que incluem um valor imdb.rating.
Usa $group para colocar os filmes correspondentes em um único grupo Short.
Usa sortBy: { "imdb.rating": -1, title: 1 } para classificar filmes por avaliação e usa title como critério de desempate.
Especifica os campos retornados por $topN com output: [ "$title", "$imdb.rating" ].
Usa $topN para retornar os três principais filmes correspondentes com n: 3.

Encontrar os filmes com classificação mais alta por gênero

Você pode usar o acumulador $topN para encontrar os filmes com maior classificação para cada gênero.

db.movies.aggregate( [   {      $unwind: "$genres"   },   {      $match: {         "imdb.rating": { $gt: 0 }      }   },   {      $group: {         _id: "$genres",         topRatedMovies: {            $topN: {               output: [ "$title", "$imdb.rating" ],               sortBy: { "imdb.rating": -1, title: 1 },               n: 3            }         }      }   },   {      $sort: { _id: 1 }   },   {      $limit: 5   }] )

[  {    _id: 'Action',    topRatedMovies: [      [ 'Band of Brothers', 9.6 ],      [ 'The Real Miyagi', 9.3 ],      [ 'The Dark Knight', 9 ]    ]  },  {    _id: 'Adventure',    topRatedMovies: [      [ 'Over the Garden Wall', 9.2 ],      [ 'Love is God', 8.9 ],      [ 'The Lord of the Rings: The Return of the King', 8.9 ]    ]  },  {    _id: 'Animation',    topRatedMovies: [      [ 'Over the Garden Wall', 9.2 ],      [ 'Death Note', 9 ],      [ 'Rabbit and Deer', 8.7 ]    ]  },  {    _id: 'Biography',    topRatedMovies: [      [ 'A Brave Heart: The Lizzie Velasquez Story', 9.4 ],      [ "Schindler's List", 8.9 ],      [ 'Shining Night: A Portrait of Composer Morten Lauridsen', 8.8 ]    ]  },  {    _id: 'Comedy',    topRatedMovies: [      [ 'Over the Garden Wall', 9.2 ],      [ 'Heart of a Dog', 9 ],      [ 'The Chaos Class Failed the Class', 9 ]    ]  }]

O exemplo de pipeline:

Usa $unwind para expandir o array genres de cada filme.
Utiliza $match para manter apenas documentos que incluem um valor imdb.rating.
Utiliza $group para agrupar os resultados por gênero.
Especifica os campos retornados por $topN com output: [ "$title", "$imdb.rating" ].
Usa sortBy: { "imdb.rating": -1, title: 1 } para classificar filmes por avaliação e usa title como um desempate determinístico.
Usa $topN para retornar os três principais filmes para cada gênero com n: 3.
Usa $sort e $limit para mostrar os cinco primeiros gêneros em ordem alfabética.

Definir n dinamicamente com base na chave de grupo

Você pode atribuir o valor de n dinamicamente. O exemplo a seguir usa a $cond expressão para retornar diferentes números de filmes com base na classificação de conteúdo.

db.movies.aggregate( [   {      $match: {         rated: { $in: [ "G", "PG", "PG-13", "R" ] },         "imdb.rating": { $gt: 0 }      }   },   {      $group: {         _id: { rated: "$rated" },         movies: {            $topN: {               output: { title: "$title", rating: "$imdb.rating" },               n: {                  $cond: {                     if: { $eq: [ "$rated", "PG" ] },                     then: 3,                     else: 1                  }               },               sortBy: { "imdb.rating": -1 }            }         }      }   },   {      $sort: { "_id.rated": 1 }   }] )

[  {    _id: { rated: 'G' },    movies: [ { title: 'Modern Times', rating: 8.6 } ]  },  {    _id: { rated: 'PG' },    movies: [      { title: 'Life', rating: 9.2 },      {        title: 'Star Wars: Episode V - The Empire Strikes Back',        rating: 8.8      },      { title: 'Andaz Apna Apna', rating: 8.8 }    ]  },  {    _id: { rated: 'PG-13' },    movies: [      {        title: 'A Brave Heart: The Lizzie Velasquez Story',        rating: 9.4      }    ]  },  {    _id: { rated: 'R' },    movies: [ { title: 'The Shawshank Redemption', rating: 9.3 } ]  }]

O exemplo de pipeline:

Usa $match para manter apenas filmes com classificações de conteúdo G, PG, PG-13 ou R que incluem um valor imdb.rating.
Utiliza $group para agrupar os resultados por classificação de conteúdo com _id: { rated: "$rated" }.
Especifica os campos retornados por $topN com output: { title: "$title", rating: "$imdb.rating" }.
Se a classificação do conteúdo for PG, então n será 3. Caso contrário, n é 1.
Usa sortBy: { "imdb.rating": -1 } para encontrar os n melhores filmes com base na pontuação do IMDb.
Classifica os resultados por classificação de conteúdo em ordem alfabética.

Saiba mais

Voltar

$top

Update