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.

$bottomN (operador de acumulación)

$bottomN

Nuevo en la versión 5.2.

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

Nota

Desambiguación

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

También puede usar bottomN en estos otros contextos:

  • $bottomN (window function) devuelve los n elementos inferiores de los documentos en una ventana determinada según el orden de acomodo especificado.

  • $bottomN (expression operator) devuelve los n elementos más bajos de un arreglo de valores de entrada según el orden de clasificación especificado.

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

n

Requerido

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

output

Requerido

Determina la salida de cada elemento del grupo. Puede ser cualquier expresión.

sortBy

Requerido

Define el orden de clasificación de los elementos dentro de cada grupo, con una sintaxis similar a $sort. No afecta el orden de los documentos en la salida del pipeline.

  • $bottomN no filtra los valores nulos.

  • $bottomN 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: { $bottomN: { 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 final del arreglo playerId devuelto.

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

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: { $bottomN: { 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 $bottomN para encontrar las tres películas con la calificación más baja en el género Short.

db.movies.aggregate( [ { $match: { genres: "Short", "imdb.rating": { $exists: true } } }, { $group: { _id: "Short", lowestRatedMovies: { $bottomN: { 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 $bottomN con output: [ "$title", "$imdb.rating" ].

  • Utiliza $bottomN para devolver las tres películas coincidentes de menor puntuación con n: 3.

Puede utilizar el acumulador $bottomN para buscar las películas peor valoradas para cada género.

db.movies.aggregate( [ { $unwind: "$genres" }, { $match: { "imdb.rating": { $exists: true } } }, { $group: { _id: "$genres", lowestRatedMovie: { $bottomN: { 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 $bottomN 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 $bottomN para devolver las tres películas con la puntuación más baja 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": { $exists: true } } }, { $group: { _id: { rated: "$rated" }, movies: { $bottomN: { 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 $bottomN 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 películas con la puntuación más baja según la puntuación de IMDb.

  • Ordena los resultados alfabéticamente por clasificación de contenido.