/ /

$maxN (operador de expressão )

Definição

$maxN: Retorna os maiores valores de n em uma array.

Observação

Outros usos de $maxN

Esta página descreve $maxN quando usado como uma expressão, que retorna os maiores valores n de um array.

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

$maxN (accumulator), que retorna os n valores máximos dentro de um grupo.
$maxN (window function), que é usado no estágio $setWindowFields para retornar os maiores valores n de documentos em uma janela específica.

Sintaxe

{ $maxN: { n: <expression>, input: <expression> } }

Campo	Tipo	Descrição
`n`	Expressão	Especifica o número de elementos a serem retornados. Deverá ser resolvido para um número inteiro positivo.
`input`	Expressão	Especifica o array de entrada a partir do qual retornar o máximo de `n` elementos.

Comportamento

$maxN filtro null valores.
Se o array input contiver menos de n elementos, $maxN retornará todos os elementos no array.
Se input resolver para um valor que não seja da array, a operação retorna um erro.
Se input contiver elementos numéricos e de string, os elementos de string serão classificados antes dos elementos numéricos de acordo com a ordem de comparação BSON.

Exemplo

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.

O exemplo a seguir usa $maxN para retornar os dois últimos membros do elenco em ordem alfabética para cada filme, armazenados em um novo campo topTwoCast criado por $addFields.

db.movies.aggregate( [
   {
      $match: {
         title: { $in: [ "The Godfather", "Spirited Away", "The Dark Knight" ] }
      }
   },
   {
      $addFields: {
         topTwoCast: { $maxN: { n: 2, input: "$cast" } }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         cast: 1,
         topTwoCast: 1
      }
   },
   {
      $sort: { title: 1 }
   }
] )

[
  {
    title: 'Spirited Away',
    cast: [ 'Rumi Hiiragi', 'Miyu Irino', 'Mari Natsuki', 'Takashi Naitè' ],
    topTwoCast: [ 'Takashi Naitè', 'Rumi Hiiragi' ]
  },
  {
    title: 'The Dark Knight',
    cast: [ 'Christian Bale', 'Heath Ledger', 'Aaron Eckhart', 'Michael Caine' ],
    topTwoCast: [ 'Michael Caine', 'Heath Ledger' ]
  },
  {
    title: 'The Godfather',
    cast: [ 'Marlon Brando', 'Al Pacino', 'James Caan', 'Richard S. Castellano' ],
    topTwoCast: [ 'Richard S. Castellano', 'Marlon Brando' ]
  }
]

O pipeline anterior:

Usa $match para filtro três filmes específicos.
Usa $addFields com $maxN para criar um novo campo topTwoCast contendo os dois últimos valores em ordem alfabética do array cast com n: 2.
Usa $project para incluir apenas os campos title, cast e topTwoCast na saída.
Usa $sort para classificar os resultados por título.

Saiba mais

Limites de Pipeline de Agregação

Voltar

$max

$mergeObjects