Definición
Devuelve el elemento principal dentro de una ventana según el orden de acomodo especificado.
Nota
Desambiguación
Esta página describe $top cuando se utiliza como función de ventana. También puede usar $top en estos otros contextos:
$top (expression operator), que devuelve el elemento principal de un arreglo según un orden de acomodo especificado.$top (accumulator), que devuelve el elemento principal dentro de un grupo según el orden de acomodo especificado.
Sintaxis
{ $setWindowFields: { ... output: { <field>: { $top: { sortBy: { <field1>: <sort order>, <field2>: <sort order> ... }, output: <expression> } } } }}Campo | Necesidad | Descripción |
|---|---|---|
sortBy | Requerido | Define el orden de clasificación de los elementos dentro de la ventana, con una sintaxis similar a |
salida | Requerido | Especifica la salida para cada elemento de la ventana. Puede ser cualquier expresión. |
Comportamiento
La función de ventana $top tiene los siguientes comportamientos para valores nulos y ausentes:
$topno filtra los valores nulos.$topconvierte 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.
Buscar la película con la calificación más alta cada año dentro de una ventana
Este ejemplo utiliza $top como función de ventana para identificar la película mejor valorada del mismo año para cada documento de película. Al conjunto de datos se le aplica un filtro para incluir solo películas familiares con clasificación PG de 1980a1982.
db.movies.aggregate( [ { $match: { year: { $in: [ 1980, 1981, 1982 ] }, "imdb.rating": { $exists: true, $ne: null }, genres: "Family", rated: "PG" } }, { $setWindowFields: { partitionBy: "$year", output: { highestRatedInYear: { $top: { output: { title: "$title", rating: "$imdb.rating" }, sortBy: { "imdb.rating": -1 } }, window: { documents: [ "unbounded", "unbounded" ] } } } } }, { $project: { _id: 0, title: 1, year: 1, rating: "$imdb.rating", highestRatedInYear: 1 } }, { $limit: 10 }] )En este ejemplo:
La etapa
$matchfiltro por películas familiares con clasificación PG de 1980-1982 para producir un conjunto de resultados pequeño y enfocado.$setWindowFieldsparticiona los documentos poryear.La ventana abarca desde
unboundedhastaunbounded, lo que significa que$topconsidera todos los documentos de la partición al determinar la película mejor valorada.$topdevuelve la película mejor valorada en cada partición como un documento incrustado que contiene los campostitleyrating.$projectincluye solo los campostitle,year,ratingy elhighestRatedInYearen la salida.$limitlimita la salida a 10 documentos.
Este enfoque conserva todos los documentos de películas individuales e incluye una referencia al mejor resultado de cada año.