Definición
Devuelve los n elementos principales dentro de una ventana determinada, según el orden de acomodo especificado.
Nota
Otros usos de $topN
Esta página describe $topN cuando se utiliza como función de ventana.
También puede usar $topN en estos otros contextos:
$topN (accumulator), que devuelve losnelementos principales dentro de un grupo según el orden de acomodo especificado.$topN (expression), que devuelve losnprimeros elementos de un arreglo.
Sintaxis
{ $setWindowFields: { ... output: { <field>: { $topN: { n: <expression>, output: <expression>, sortBy: { <field1>: <sort order>, <field2>: <sort order>, ... } } } } }}opciones
Campo | Necesidad | Descripción |
|---|---|---|
| Requerido | Cantidad de resultados a devolver. Debe evaluarse como un valor integral positivo. Si la ventana contiene menos de |
| Requerido | Determina la salida para cada documento en la ventana. Puede ser cualquier expresión. |
| Requerido | Define el orden de clasificación de los elementos dentro de la ventana, con una sintaxis similar a |
Comportamiento
Valores nulos y faltantes
$topNno filtra los valores nulos.$topNconvierte los valores faltantes en null.
Ejemplo
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 en una ventana
Este ejemplo utiliza $topN en $setWindowFields para devolver cada película con las tres películas mejor valoradas estrenadas en el mismo año.
db.movies.aggregate( [ { $match: { year: { $in: [ 1999, 2001 ] }, "imdb.rating": { $gte: 8.5 } } }, { $setWindowFields: { partitionBy: "$year", output: { topThreeRatedInYear: { $topN: { sortBy: { "imdb.rating": -1, title: 1 }, output: { rating: "$imdb.rating", title: "$title" }, n: 3 }, window: { documents: [ "unbounded", "unbounded" ] } } } } }, { $project: { _id: 0, title: 1, year: 1, "imdb.rating": 1, topThreeRatedInYear: 1 } }, { $sort: { year: 1, "imdb.rating": -1 } }] )En el ejemplo precedente:
$matchfiltros para películas estrenadas en1999o2001con una calificación de IMDb de al menos8.5.$setWindowFieldsparticiona los documentos poryear.window: { documents: [ "unbounded", "unbounded" ] }abarca toda la partición del año, por lo que$topNconsidera todos los documentos del año al determinar las tres películas mejor valoradas.$topNutilizasortBy: { "imdb.rating": -1, title: 1 }para clasificar películas por puntuación de IMDb y utilizatitlecomo desempate. Cada documento del mismo año recibe el mismo valortopThreeRatedInYear.$projectremueve campos innecesarios para resaltar el resultado de la función de ventana.$sortordena la salida por año ascendente y calificación descendente.