$maxN (operador acumulador )

Tipo de resultado

Quando $maxN compara valores de tipos diferentes, a ordem dos tipos segue a ordem de comparação BSON.

Valores nulos e ausentes

$maxN filtra valores nulos e ausentes.

A seguinte agregação demonstra como o $maxN lida com valores nulos e ausentes:

db.aggregate( [
   {
      $documents: [
         { title: "Fight Club", genre: "Drama", rating: 8.9 },
         { title: "The Matrix", genre: "Drama", rating: 8.7 },
         { title: "The Green Mile", genre: "Drama", rating: 8.5 },
         { title: "Magnolia", genre: "Drama" },
         { title: "Dogma", genre: "Drama", rating: null }
      ]
   },
   {
      $group: {
         _id: "$genre",
         topFourRatings: {
            $maxN: {
               input: "$rating",
               n: 4
            }
         }
      }
   }
] )

[
   {
      _id: 'Drama',
      topFourRatings: [ 8.9, 8.7, 8.5 ]
   }
]

Neste exemplo:

• $documents cria os documentos literais que contêm classificações de filmes.

• $group agrupa os documentos por genre. Este exemplo tem apenas um genre, Drama.

• Magnolia tem um rating ausente e Dogma tem um rating nulo. Ambos os valores são filtrados.

• Como apenas 3 documentos têm classificações válidas, $maxN retorna valores 3 mesmo que n = 4.

Comparação de acumuladores $maxN e $topN

Você pode usar $maxN ou $topN para retornar os elementos n com a classificação mais alta de um grupo. A escolha entre eles depende se seus documentos de entrada já estão classificados.

• Se os documentos de entrada já estiverem classificados, use $maxN para retornar os valores máximos de n.

• Se você precisar classificar e selecionar os principais elementos n ao mesmo tempo, use $topN para fazer ambos com um único acumulador.

Encontre os três filmes mais bem avaliados em um único ano

Você pode usar o acumulador $maxN para encontrar as três classificações mais altas do IMDb para filmes lançados em um único ano.

db.movies.aggregate( [
   {
      $match: {
         year: 1999,
         "imdb.rating": { $exists: true }
      }
   },
   {
      $group: {
         _id: 1999,
         topThreeRatings: {
            $maxN: {
               input: "$imdb.rating",
               n: 3
            }
         }
      }
   }
] )

[ { _id: 1999, topThreeRatings: [ 8.9, 8.7, 8.7 ] } ]

O pipeline anterior:

• Usa $match para filtrar filmes lançados em 1999 que têm um campoimdb.rating.

• Agrupa todos os documentos correspondentes em um único grupo com _id: 1999.

• Especifica "$imdb.rating" como input para $maxN.

• Usa $maxN para retornar as três classificações mais altas com n: 3.

Encontre os três filmes mais bem avaliados em vários anos

Você pode usar o acumulador $maxN para encontrar os três filmes mais bem avaliados de cada ano em um conjunto de anos.

db.movies.aggregate( [
   {
      $match: {
         year: { $in: [ 1999, 2000, 2001 ] },
         "imdb.rating": { $exists: true }
      }
   },
   {
      $group: {
         _id: "$year",
         topThreeRatings: {
            $maxN: {
               input: "$imdb.rating",
               n: 3
            }
         }
      }
   },
   { $sort: { _id: 1 } }
] )

[
  { _id: 1999, topThreeRatings: [ 8.9, 8.7, 8.7 ] },
  { _id: 2000, topThreeRatings: [ 8.5, 8.5, 8.5 ] },
  { _id: 2001, topThreeRatings: [ 9.6, 9.2, 8.8 ] }
]

O pipeline anterior:

• Usa $match para filtrar filmes lançados em 1999, 2000 ou 2001 que tenham um campoimdb.rating.

• Utiliza $group para agrupar filmes por year.

• Especifica "$imdb.rating" como input para $maxN.

• Usa $maxN para retornar as três classificações mais altas por ano com n: 3.

• Classifica os resultados por ano em ordem crescente.

Definir n com base na chave do grupo

Você pode atribuir o valor de n dinamicamente com base na chave do grupo. Neste exemplo, a expressão $cond utiliza o campo year para alterar o valor de n:

db.movies.aggregate( [
   {
      $match: {
         year: { $in: [ 1999, 2000, 2001 ] },
         "imdb.rating": { $exists: true }
      }
   },
   {
      $group: {
         _id: { year: "$year" },
         topRatedMovies: {
            $maxN: {
               input: "$imdb.rating",
               n: { $cond: {
                  if: { $eq: [ "$year", 2001 ] },
                  then: 3,
                  else: 1
               } }
            }
         }
      }
   },
   { $sort: { "_id.year": 1 } }
] )

[
  { _id: { year: 1999 }, topRatedMovies: [ 8.9 ] },
  { _id: { year: 2000 }, topRatedMovies: [ 8.5 ] },
  { _id: { year: 2001 }, topRatedMovies: [ 9.6, 9.2, 8.8 ] }
]

O pipeline anterior:

• Filtros para filmes lançados em 1999, 2000 ou 2001 que tenham um campoimdb.rating.

• Agrupa filmes por year.

• Usa a expressão $cond para retornar classificações de 3 para o ano 2001 e classificação 1 para todos os outros anos.

Na saída, 2001 retorna três classificações, enquanto 1999 e 2000 retornam uma classificação.