$maxN (operador acumulador)

Tipo de resultado

Cuando $maxN compara valores de diferentes tipos, el orden de los tipos sigue el orden de comparación BSON.

Valores nulos y faltantes

$maxN filtra los valores nulos y ausentes.

La siguiente agregación demuestra cómo $maxN maneja los valores nulos y faltantes:

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 ]
   }
]

En este ejemplo:

• $documents crea los documentos literales que contienen las calificaciones de las películas.

• $group agrupa los documentos por genre. Este ejemplo tiene solo un genre, Drama.

• Magnolia tiene un rating faltante y Dogma tiene un rating nulo. Ambos valores se filtran.

• Dado que solo los documentos 3 tienen calificaciones válidas, $maxN devuelve valores 3 aunque n = 4.

Comparación de los acumuladores $maxN y $topN

Puedes usar $maxN o $topN para devolver los elementos n mejor clasificados de un grupo. La elección entre ellos depende de si tus documentos de entrada ya están ordenados.

• Si los documentos de entrada ya están ordenados, utilice $maxN para devolver los valores máximos de n.

• Si necesita ordenar y seleccionar los elementos n superiores al mismo tiempo, utilice $topN para lograr ambas cosas con un solo acumulador.

Encuentra las tres películas mejor valoradas de un solo año.

Puedes usar el acumulador $maxN para encontrar las tres calificaciones más altas de IMDb para películas estrenadas en un solo año.

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 ] } ]

La tubería precedente:

• Utiliza $match para filtrar las películas estrenadas en 1999 que tienen un campo imdb.rating.

• Agrupa todos los documentos coincidentes en un único grupo con _id: 1999.

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

• Utiliza $maxN para devolver las tres calificaciones más altas con n: 3.

Encuentra las tres películas mejor valoradas de varios años.

Puedes usar el acumulador $maxN para encontrar las tres películas mejor valoradas de cada año en un conjunto de años.

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 ] }
]

La tubería precedente:

• Utiliza $match para filtrar películas estrenadas en 1999, 2000 o 2001 que tengan un campo imdb.rating.

• Utiliza $group para agrupar películas por year.

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

• Utiliza $maxN para devolver las tres calificaciones más altas por año con n: 3.

• Ordena los resultados por año en orden ascendente.

Establecer n en función de la clave de grupo.

Puede asignar el valor de n dinámicamente en función de la clave de grupo. En este ejemplo, la expresión $cond utiliza el campo year para cambiar el 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 ] }
]

La tubería precedente:

• Filtros para películas estrenadas en 1999, 2000 o 2001 que tengan un campo imdb.rating.

• Agrupa las películas por year.

• Utiliza la expresión $cond para devolver las calificaciones 3 para el año 2001 y la calificación 1 para todos los demás años.

En la salida, 2001 devuelve tres calificaciones, mientras que 1999 y 2000 devuelven una calificación cada una.