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.

$topN (operador de acumulación)

$topN

Devuelve una agregación de los n elementos principales dentro de un grupo, de acuerdo con el orden de clasificación especificado. Si el grupo contiene menos de n elementos, $topN devuelve todos los elementos del grupo.

Nota

Otros usos de $topN

Esta página describe $topN cuando se utiliza como acumulador. Los acumuladores devuelven un valor agregado en un grupo de documentos de entrada.

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

  • $topN (window function), que devuelve los n elementos principales de los documentos en una ventana determinada según el orden de clasificación especificado.

  • $topN (expression), que devuelve los n primeros elementos de un arreglo.

{ $topN: { n: <expression>, sortBy: { <field1>: <sort order>, <field2>: <sort order> ... }, output: <expression> }}
Campo
Tipo
Descripción

n

expresión

Determina el número máximo de resultados devueltos por grupo. n debe evaluarse como un entero positivo.

sortBy

Documento

Especifica el orden de los resultados, con una sintaxis similar a $sort. No afecta el orden de los documentos en la salida del pipeline.

output

expresión

Especifica la salida para cada elemento del grupo. Puede ser cualquier expresión.

  • $topN no filtra los valores nulos.

  • $topN convierte los valores faltantes a nulos, que se conservan en el resultado.

db.aggregate( [ { $documents: [ { playerId: "PlayerA", gameId: "G1", score: 1 }, { playerId: "PlayerB", gameId: "G1", score: 2 }, { playerId: "PlayerC", gameId: "G1", score: 3 }, { playerId: "PlayerD", gameId: "G1"}, { playerId: "PlayerE", gameId: "G1", score: null } ] }, { $group: { _id: "$gameId", playerId: { $topN: { output: [ "$playerId", "$score" ], sortBy: { "score": 1 }, n: 3 } } } }] )

En este ejemplo:

  • $documents crea los documentos literales que contienen las puntuaciones de los jugadores.

  • $group agrupa los documentos por gameId. Este ejemplo tiene solo un gameId, G1.

  • PlayerD tiene una puntuación faltante y PlayerE tiene un score nulo. Estos valores se consideran ambos nulos.

  • Los campos playerId y score se especifican como output : ["$playerId"," $score"] y se devuelven como valores de un arreglo.

  • Debido al sortBy: { "score" : 1 }, los valores nulos se ordenan al principio del arreglo de playerId devueltos.

[ { _id: 'G1', playerId: [ [ 'PlayerD', null ], [ 'PlayerE', null ], [ 'PlayerA', 1 ] ] }]

Al ordenar diferentes tipos, se utiliza el orden de los tipos de datos BSON para determinar el orden. Como ejemplo, consideremos una colección cuyos valores consisten en cadenas y números.

  • En una ordenación ascendente, los valores de string se ordenan después de los valores numéricos.

  • En una ordenación descendente, los valores de string se ordenan antes que los valores numéricos.

db.aggregate( [ { $documents: [ { playerId: "PlayerA", gameId: "G1", score: 1 }, { playerId: "PlayerB", gameId: "G1", score: "2" }, { playerId: "PlayerC", gameId: "G1", score: "" } ] }, { $group: { _id: "$gameId", playerId: { $topN: { output: ["$playerId","$score"], sortBy: {"score": -1}, n: 3 } } } }] )

En este ejemplo:

  • PlayerA tiene una puntuación entera.

  • PlayerB tiene una puntuación de string "2".

  • PlayerC tiene un puntaje de string vacía.

Debido a que el ordenamiento es descendente { "score" : -1 }, los valores de literales de string se ordenan antes de la puntuación numérica de PlayerA:

[ { _id: "G1", playerId: [ [ "PlayerB", "2" ], [ "PlayerC", "" ], [ "PlayerA", 1 ] ] }]

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 $topN para encontrar las tres películas mejor valoradas del género Short.

db.movies.aggregate( [ { $match: { genres: "Short", "imdb.rating": { $gt: 0 } } }, { $group: { _id: "Short", topRatedMovies: { $topN: { output: [ "$title", "$imdb.rating" ], sortBy: { "imdb.rating": -1, title: 1 }, n: 3 } } } }] )

La pipeline de ejemplo:

  • Utiliza $match para restringir la entrada a Short películas que incluyen un valor imdb.rating.

  • Utiliza $group para colocar las películas coincidentes en un único grupo Short.

  • Utiliza sortBy: { "imdb.rating": -1, title: 1 } para clasificar películas por calificación y utiliza title como desempate.

  • Especifica los campos devueltos por $topN con output: [ "$title", "$imdb.rating" ].

  • Utiliza $topN para devolver las tres películas que más coinciden con n: 3.

Puede utilizar el acumulador $topN para encontrar las películas mejor valoradas para cada género.

db.movies.aggregate( [ { $unwind: "$genres" }, { $match: { "imdb.rating": { $gt: 0 } } }, { $group: { _id: "$genres", topRatedMovies: { $topN: { output: [ "$title", "$imdb.rating" ], sortBy: { "imdb.rating": -1, title: 1 }, n: 3 } } } }, { $sort: { _id: 1 } }, { $limit: 5 }] )

La pipeline de ejemplo:

  • Utiliza $unwind para expandir el arreglo genres de cada película.

  • Utiliza $match para conservar solo los documentos que incluyen un valor imdb.rating.

  • Utiliza $group para agrupar los resultados por género.

  • Especifica los campos devueltos por $topN con output: [ "$title", "$imdb.rating" ].

  • Utiliza sortBy: { "imdb.rating": -1, title: 1 } para clasificar películas por calificación y utiliza title como desempate determinista.

  • Utiliza $topN para devolver las tres mejores películas de cada género con n: 3.

  • Utiliza $sort y $limit para mostrar los cinco primeros géneros alfabéticamente.

Puede asignar el valor de n dinámicamente. El siguiente ejemplo utiliza la expresión $cond para devolver diferentes números de películas según la clasificación del contenido.

db.movies.aggregate( [ { $match: { rated: { $in: [ "G", "PG", "PG-13", "R" ] }, "imdb.rating": { $gt: 0 } } }, { $group: { _id: { rated: "$rated" }, movies: { $topN: { output: { title: "$title", rating: "$imdb.rating" }, n: { $cond: { if: { $eq: [ "$rated", "PG" ] }, then: 3, else: 1 } }, sortBy: { "imdb.rating": -1 } } } } }, { $sort: { "_id.rated": 1 } }] )

La pipeline de ejemplo:

  • Utiliza $match para conservar solo las películas con calificaciones de contenido G, PG, PG-13 o R que incluyan un valor imdb.rating.

  • Utiliza $group para agrupar los resultados por calificación de contenido con _id: { rated: "$rated" }.

  • Especifica los campos devueltos por $topN con output: { title: "$title", rating: "$imdb.rating" }.

  • Si la clasificación del contenido es PG, entonces n es 3. De lo contrario, n es 1.

  • Utiliza sortBy: { "imdb.rating": -1 } para encontrar las n mejores películas según la puntuación de IMDb.

  • Ordena los resultados por clasificación de contenido en orden alfabético.