/ /

$maxN (função de janela)

Definição

$maxN

Retorna uma array contendo o máximo de n elementos dentro de uma janela.

Observação

Outros usos de $maxN

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

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

$maxN (accumulator), que retorna os valores máximos de n dentro de um grupo.
$maxN (expression), que retorna os maiores valores n de uma array.

Sintaxe

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $maxN: {
               input: <expression>,
               n: <expression>
            },
            window: {
               documents: [ <lower boundary>, <upper boundary> ]
            }
         }
      }
   }
}

Opções

Campo	Tipo	Descrição
`input`	Expressão	A expressão avaliada em cada documento na janela. `$maxN` retorna os valores máximos de `n`.
`n`	Expressão	O número de elementos que `$maxN` retorna da janela. Deve resolver para um número inteiro positivo. Se a janela tiver menos de `n` elementos, `$maxN` retornará todos os elementos na janela.

Comportamento

Valores nulos e ausentes

$maxN filtra valores nulos e ausentes.

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 $maxN em $setWindowFields para retornar os três filmes mais bem avaliados de cada ano. A janela abrange toda a partição, de modo que todos os documento no mesmo ano recebam o mesmo valor topThreeRatedInYear.

db.movies.aggregate( [
   {
      $match: {
         year: { $in: [ 1999, 2001 ] },
         "imdb.rating": { $gte: 8.5 }
      }
   },
   {
      $setWindowFields: {
         partitionBy: "$year",
         sortBy: { "imdb.rating": -1 },
         output: {
            topThreeRatedInYear: {
               $maxN: {
                  input: [ "$imdb.rating", "$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: [
      [ 8.9, 'Fight Club' ],
      [ 8.7, 'The Matrix' ],
      [ 8.7, 'Eddie Izzard: Dress to Kill' ]
    ]
  },
  {
    imdb: { rating: 8.7 },
    year: 1999,
    title: 'The Matrix',
    topThreeRatedInYear: [
      [ 8.9, 'Fight Club' ],
      [ 8.7, 'The Matrix' ],
      [ 8.7, 'Eddie Izzard: Dress to Kill' ]
    ]
  },
  {
    title: 'Eddie Izzard: Dress to Kill',
    year: 1999,
    imdb: { rating: 8.7 },
    topThreeRatedInYear: [
      [ 8.9, 'Fight Club' ],
      [ 8.7, 'The Matrix' ],
      [ 8.7, 'Eddie Izzard: Dress to Kill' ]
    ]
  },
  {
    imdb: { rating: 8.5 },
    year: 1999,
    title: 'The Green Mile',
    topThreeRatedInYear: [
      [ 8.9, 'Fight Club' ],
      [ 8.7, 'The Matrix' ],
      [ 8.7, 'Eddie Izzard: Dress to Kill' ]
    ]
  },
  {
    title: 'Band of Brothers',
    year: 2001,
    imdb: { rating: 9.6 },
    topThreeRatedInYear: [
      [ 9.6, 'Band of Brothers' ],
      [ 9.2, 'The Blue Planet' ],
      [
        8.8,
        'The Lord of the Rings: The Fellowship of the Ring'
      ]
    ]
  },
  {
    title: 'The Blue Planet',
    year: 2001,
    imdb: { rating: 9.2 },
    topThreeRatedInYear: [
      [ 9.6, 'Band of Brothers' ],
      [ 9.2, 'The Blue Planet' ],
      [
        8.8,
        '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: [
      [ 9.6, 'Band of Brothers' ],
      [ 9.2, 'The Blue Planet' ],
      [
        8.8,
        'The Lord of the Rings: The Fellowship of the Ring'
      ]
    ]
  },
  {
    imdb: { rating: 8.6 },
    year: 2001,
    title: 'Spirited Away',
    topThreeRatedInYear: [
      [ 9.6, 'Band of Brothers' ],
      [ 9.2, 'The Blue Planet' ],
      [
        8.8,
        'The Lord of the Rings: The Fellowship of the Ring'
      ]
    ]
  },
  {
    title: 'Promises',
    year: 2001,
    imdb: { rating: 8.5 },
    topThreeRatedInYear: [
      [ 9.6, 'Band of Brothers' ],
      [ 9.2, 'The Blue Planet' ],
      [
        8.8,
        'The Lord of the Rings: The Fellowship of the Ring'
      ]
    ]
  }
]

O pipeline anterior:

Usa $match para filtrar filmes lançados em 1999 ou 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 $maxN com n: 3 para criar topThreeRatedInYear a partir de uma janela que abrange toda a partição (documents: ["unbounded", "unbounded"]).
Usa $project para incluir somente os campos title, year, imdb.rating e topThreeRatedInYear no resultado.
Utiliza $sort para classificar os resultados por ano crescente e classificação decrescente.

Saiba mais

Limites de Pipeline de Agregação

Voltar

$max

$median