$maxN (operador de array)

Nesta página

Definição

Sintaxe
Comportamento
Exemplo

Definição

$maxN: Novidades na versão 5.2.
Retorna os maiores valores de n em uma array.

Dica

Veja também:

$minN

Sintaxe

$maxN tem a seguinte sintaxe:

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

Campo	Descrição
`n`	Uma expressão que se resolve para um número inteiro positivo. O número inteiro especifica o número de elementos de array que `$maxN` retorna.
`input`	Uma expressão que se resolve para a array a partir da qual retornar o máximo `n` elementos.

Comportamento

Você não pode especificar um valor de n menor que 1.
$maxN filtra os valores de null encontrados no array input.
Se o n especificado for igual ao ou maior que número de elementos no array input , $maxN retornará todos os elementos no array input.
Se input resolver para um valor que não seja da array, a operação de agregação será executada.
Se input contiver elementos numéricos e string , os elementos de string serão classificados antes dos elementos numéricos, de acordo com a ordem de comparação deBSON .

Exemplo

Criar uma coleção scores com os seguintes documentos:

db.scores.insertMany([
    { "playerId" : 1, "score" : [ 1, 2, 3 ] },
    { "playerId" : 2, "score" : [ 12, 90, 7, 89, 8 ] },
    { "playerId" : 3, "score" : [ null ] },
    { "playerId" : 4, "score" : [ ] }
    { "playerId" : 5, "score" : [ 1293, "2", 3489, 9 ]}
])

O exemplo seguinte utiliza o operador $maxN para recuperar as duas pontuações mais altas para cada jogador. As pontuações mais altas são retornadas no novo campo maxScores criado por $addFields.

db.scores.aggregate([
   { $addFields: { maxScores: { $maxN: { n: 2, input: "$score" } } } }
])

A operação retorna os seguintes resultados:

[{
  "playerId": 1,
  "score": [ 1, 2, 3 ],
  "maxScores": [ 3, 2 ]
},
{
  "playerId": 2,
  "score": [ 12, 90, 7, 89, 8 ],
  "maxScores": [ 90, 89 ]
},
{
  "playerId": 3,
  "score": [ null ],
  "maxScores": [ ]
},
{
  "playerId": 4,
  "score": [ ],
  "maxScores": [ ]
},
{
  "playerId": 5,
  "score": [ 1293, "2", 3489, 9 ],
  "maxScores": [ "2", 3489 ]
}]

Voltar

$maxN

$median