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.

$top (función de ventana)

$top

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.

{ $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 $sort. No afecta el orden de los documentos en la salida del pipeline.

salida

Requerido

Especifica la salida para cada elemento de la ventana. Puede ser cualquier expresión.

La función de ventana $top tiene los siguientes comportamientos para valores nulos y ausentes:

  • $top no filtra los valores nulos.

  • $top convierte los valores faltantes en null.

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.

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 $match filtro por películas familiares con clasificación PG de 1980-1982 para producir un conjunto de resultados pequeño y enfocado.

  • $setWindowFields particiona los documentos por year.

  • La ventana abarca desde unbounded hasta unbounded, lo que significa que $top considera todos los documentos de la partición al determinar la película mejor valorada.

  • $top devuelve la película mejor valorada en cada partición como un documento incrustado que contiene los campos title y rating.

  • $project incluye solo los campos title, year, rating y el highestRatedInYear en la salida.

  • $limit limita 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.

Califique esta página

Documentación