Definición
$maxNDevuelve una agregación de los elementos
ncon el valor máximo en un grupo. Si el grupo contiene menos denelementos,$maxNdevuelve 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 (expression), que devuelve losnvalores más grandes de un arreglo.$maxN (window function), que se utiliza en la$setWindowFieldsetapa para devolver losnvalores más grandes de los documentos en una ventana determinada.
Sintaxis
{ $maxN: { input: <expression>, n: <expression> }}Campo | Tipo | Descripción |
|---|---|---|
| expresión | La expresión evaluada para cada elemento del grupo. |
| expresión | El número de elementos que |
Comportamiento
Tipo de resultado
Cuando $maxN compara valores de diferentes tipos, el orden de los tipos sigue el orden de comparación de BSON.
Valores nulos y faltantes
$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:
$documentscrea los documentos literales que contienen calificaciones de películas.$groupagrupa los documentos porgenre. Este ejemplo tiene solo ungenre,Drama.Magnoliatiene unratingfaltante yDogmatiene unratingnulo. Ambos valores se filtran.Dado que solo 3 documentos tienen calificaciones válidas,
$maxNdevuelve 3 valores a pesar de quen = 4.
Comparación de los acumuladores $maxN y $topN
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
$maxNpara devolver losnvalores máximos.Si necesita ordenar y seleccionar los
nelementos principales al mismo tiempo, utilice$topNpara lograr ambos con un único acumulador.
Ejemplos
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.
Encontrar las tres películas mejor valoradas de un año
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
$matchpara usar un filtro para películas estrenadas en1999que tienen un campoimdb.rating.Agrupa todos los documentos coincidentes en un único grupo con
_id: 1999.Especifica
"$imdb.rating"como elinputpara$maxN.Utiliza
$maxNpara devolver las tres calificaciones más altas conn: 3.
Encontrar las tres películas mejor valoradas a lo largo de varios años
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
$matchpara filtro películas estrenadas en1999,2000o2001que tienen un campoimdb.rating.Utiliza
$grouppara agrupar películas poryear.Especifica
"$imdb.rating"como elinputpara$maxN.Utiliza
$maxNpara devolver las tres puntuaciones más altas por año conn: 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 } }] )El pipeline anterior:
Filtros para películas lanzadas en
1999,2000o2001que tienen un campoimdb.rating.Agrupa las películas por
year.Utiliza la expresión
$condpara devolver3calificaciones para el año2001y1calificació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.