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.

$firstN (función de ventana)

$firstN

Devuelve un arreglo con los primeros n elementos dentro de una ventana.

Nota

Desambiguación

Esta página describe $firstN cuando se utiliza como función de ventana.

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

  • $firstN (accumulator), utilizado en la agrupación para devolver los primeros n elementos de cada grupo.

  • $firstN (expression), que devuelve el número especificado de elementos desde el inicio de un arreglo.

{ $setWindowFields: { ... output: { <field>: { $firstN: { input: <expression>, n: <expression> } } } }}
Campo
Tipo
Descripción

input

expresión

La expresión input se evalúa en cada documento de la ventana, y se conservan los primeros n resultados.

n

expresión

La cantidad de elementos que $firstN devuelve de la ventana. Debe evaluarse como un número entero positivo.

Si la ventana contiene menos de n elementos, $firstN devuelve todos los elementos de la ventana.

  • $firstN no filtra los valores nulos.

  • $firstN 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 $setWindowFields para particionar las películas por year, ordenarlas por imdb.rating en orden descendente y devolver las tres primeras películas de cada año. Cada película también incluye un campo que muestra los tres títulos de películas mejor valorados estrenados en ese año:

db.movies.aggregate( [ { $match: { year: { $in: [ 1999, 2000, 2001 ] }, "imdb.rating": { $gte: 8.5 } } }, { $setWindowFields: { partitionBy: "$year", sortBy: { "imdb.rating": -1 }, output: { topThreeMoviesInYear: { $firstN: { input: "$title", n: 3 }, window: { documents: [ "unbounded", "unbounded" ] } } } } }, { $project: { _id: 0, title: 1, year: 1, "imdb.rating": 1, topThreeMoviesInYear: 1 } }, { $sort: { year: 1, "imdb.rating": -1 } }] )

El pipeline anterior:

  • Utiliza la etapa $match para usar el filtro de los resultados a las películas estrenadas entre los años 1999 y 2001 con una calificación de IMDb de 8.5 o superior.

  • Utiliza $setWindowFields para particionar películas por year y ordenarlas por imdb.rating en orden descendente. La etapa utiliza $firstN con n: 3 para crear topThreeMoviesInYear a partir de una ventana definida como documents: [ "unbounded", "unbounded" ].

  • Utiliza $project para incluir solo los campos title, year, imdb.rating y topThreeMoviesInYear en la salida.

  • Utiliza $sort para ordenar los resultados por año y calificación.

Califique esta página

Documentación