Definición
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 primerosnelementos de cada grupo.$firstN (expression), que devuelve el número especificado de elementos desde el inicio de un arreglo.
Sintaxis
{ $setWindowFields: { ... output: { <field>: { $firstN: { input: <expression>, n: <expression> } } } }}opciones
Campo | Tipo | Descripción |
|---|---|---|
| expresión | La expresión |
| expresión | La cantidad de elementos que Si la ventana contiene menos de |
Comportamiento
Valores nulos y faltantes
$firstNno filtra los valores nulos.$firstNconvierte 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.
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
$matchpara 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
$setWindowFieldspara particionar películas poryeary ordenarlas porimdb.ratingen orden descendente. La etapa utiliza$firstNconn: 3para creartopThreeMoviesInYeara partir de una ventana definida comodocuments: [ "unbounded", "unbounded" ].Utiliza
$projectpara incluir solo los campostitle,year,imdb.ratingytopThreeMoviesInYearen la salida.Utiliza
$sortpara ordenar los resultados por año y calificación.