Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

$maxN (operador acumulador)

$maxN

Devuelve una agregación de los elementos n con el valor máximo en un grupo. Si el grupo contiene menos de n elementos, $maxN devuelve todos los elementos del grupo.

El acumulador $maxN está disponible en estas etapas:

Nota

Otros usos de $maxN

Esta página describe $maxN cuando se utiliza como acumulador. Los acumuladores devuelven un valor agregado como la suma, el máximo o el mínimo en un grupo de documentos de entrada.

También puede usar $maxN en estos otros contextos:

{ $maxN: { input: <expression>, n: <expression> }}
Campo
Tipo
Descripción

input

expresión

La expresión evaluada para cada elemento del grupo. $maxN conserva los valores máximos de n.

n

expresión

El número de elementos que $maxN devuelve del grupo. Para ver un ejemplo de cómo establecer n dinámicamente, consulte Establecer n en función de la clave de grupo.

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

$maxN filtra los valores nulos y ausentes.

La siguiente agregación demuestra cómo $maxN gestiona los valores nulos y 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 ] }]

En este ejemplo:

  • $documents crea los documentos literales que contienen calificaciones de 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 3 documentos tienen calificaciones válidas, $maxN devuelve 3 valores a pesar de que n = 4.

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

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

  • Si necesita ordenar y seleccionar los n elementos principales al mismo tiempo, utilice $topN para lograr ambos con un único acumulador.

Los ejemplos de esta página utilizan datos del conjunto de datos sample_mflix. Para obtener más información sobre cómo cargar este conjunto de datos en la implementación autogestionada de MongoDB, consultar Cargar el conjunto de datos de muestra. Si realizó alguna modificación en las bases de datos de muestra, es posible que deba descartar y volver a crear las bases de datos para ejecutar los ejemplos de esta página.

Puede utilizar el acumulador $maxN para encontrar las tres calificaciones IMDb más altas de 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 } } } }] )

El pipeline anterior:

  • Utiliza $match para usar un filtro para 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 el input para $maxN.

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

Puede utilizar el acumulador $maxN para encontrar las tres películas mejor valoradas para 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 } }] )

El pipeline anterior:

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

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

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

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

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

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

El pipeline anterior:

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

  • Agrupa las películas por year.

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

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