Definición
Devuelve el número especificado de elementos desde el inicio de un arreglo.
Nota
Desambiguación
Esta página describe $firstN cuando se usa como una expresión, que devuelve el número especificado de elementos desde el inicio de un arreglo.
También puede usar $firstN en estos otros contextos:
$firstN (accumulator), utilizado en la agrupación para devolver los primerosnelementos de cada grupo.$firstN (window function), que se utiliza en la$setWindowFieldsetapa para devolver los primerosnvalores de los documentos de una ventana determinada.
Sintaxis
{ $firstN: { input: <expression>, n: <expression> } }opciones
Campo | Tipo | Descripción |
|---|---|---|
| expresión | El arreglo del que devolver los primeros |
| expresión | El número de elementos que |
Comportamiento
$firstNdevuelve elementos en el mismo orden en que aparecen en el arreglo de entrada.$firstNno filtra los valoresnullen el arreglo de entrada.No puedes especificar un valor de
nmenor que1.Si el
nespecificado es mayor o igual al número de elementos en el arregloinput,$firstNdevuelve el arregloinputcompleto.Si
inputresulta en un valor que no es un arreglo, la operación de agregación genera errores.
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.
El siguiente ejemplo utiliza el operador $firstN para devolver los tres primeros nodos del reparto de cada película. Los nodos se devuelven en el nuevo campo firstThreeCast creado por $addFields.
db.movies.aggregate( [ { $match: { title: { $in: [ "The Godfather", "Spirited Away", "The Dark Knight" ] } } }, { $addFields: { firstThreeCast: { $firstN: { input: "$cast", n: 3 } } } }, { $project: { _id: 0, title: 1, cast: 1, firstThreeCast: 1 } }, { $sort: { title: 1 } }] )El pipeline anterior:
Utiliza
$matchcomo filtro para tres películas específicas.Utiliza
$addFieldscon$firstNpara crear un nuevo campofirstThreeCastque contiene los tres primeros elementos del arreglocastconn: 3.Utiliza
$projectpara incluir solo los campostitle,casty elfirstThreeCasten la salida.Utiliza
$sortpara ordenar los resultados por título.