Definición
Devuelve el valor de una expresión para el primer documento de una ventana.
Nota
Desambiguación
Esta página describe $first cuando se utiliza como función de ventana.
También puede usar $first en estos otros contextos:
$first (accumulator), utilizado en la agrupación para devolver el primer valor de cada grupo.$first (expression), que devuelve el primer elemento de un arreglo.
Sintaxis
{ $setWindowFields: { ... output: { <field>: { $first: <expression> } } }}Comportamiento
La función de ventana $first tiene los siguientes comportamientos para valores nulos y ausentes:
$firstconvierte los valores de campo que faltan anull.$firstdevuelvenullpara ventanas vacías.
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 películas por year, ordenarlas por imdb.rating en orden descendente e identificar la película mejor valorada de cada año. Cada documento incluye un campo que muestra el título de la película mejor valorada estrenada 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: { topRatedMovieInYear: { $first: "$title", window: { documents: [ "unbounded", "unbounded" ] } } } } }, { $project: { _id: 0, title: 1, year: 1, "imdb.rating": 1, topRatedMovieInYear: 1 } }, { $sort: { year: 1, "imdb.rating": -1 } }] )En el pipeline anterior:
$matchfiltros para películas de 1999-2001 con una calificación de IMDb de 8.5 o superior.$setWindowFieldsparticiona las películas poryeary las ordena porimdb.ratingen orden descendente. La etapa utiliza$firstcon una ventana definida comodocuments: [ "unbounded", "unbounded" ]para devolver el título de la película mejor valorada en la partición de cada año.$projectincluye solotitle,year,imdb.ratingytopRatedMovieInYearen la salida.$sortordena los resultados por año y calificación.