Menu Docs

Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB

$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 valores null encontrados na array input .

  • Se o n especificado for maior ou igual ao número de elementos na array input , $maxN retornará todos os elementos na array input .

  • Se input resolver para um valor que não seja do array, a operação de agregação será executada.

  • 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 de JSON.

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 ]
}]
← $maxN (acúmulo de agregação)
$mergeObjects (agregação) →

Nesta página