Definición
Devuelve el primer elemento de un arreglo.
Nota
Desambiguación
Esta página describe $first cuando se utiliza como expresión, que devuelve el primer elemento de un arreglo.
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 (window function), utilizado en la$setWindowFieldsetapa para devolver un valor para el primer documento de una ventana.
Sintaxis
{ $first: <expression> }El <expression> debe evaluarse como un arreglo.
Comportamiento
Si la expresión del operando se evalúa como un arreglo,
$firstdevuelve el primer elemento de ese arreglo.Si el arreglo está vacío,
$firstdevuelvenull.Si la expresión se evalúa en
nullo hace referencia a un campo que falta,$firstdevuelvenull.
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 $first para devolver el actor que encabeza el reparto de cada película. En el conjunto de datos sample_mflix, el arreglo cast enumera a los actores en orden de facturación, por lo que el primer elemento es el actor principal:
db.movies.aggregate( [ { $match: { title: { $in: [ "The Godfather", "Pulp Fiction", "Forrest Gump" ] } } }, { $addFields: { topBilledActor: { $first: "$cast" } } }, { $project: { _id: 0, title: 1, cast: 1, topBilledActor: 1 } }, { $sort: { title: 1 } }] )En el pipeline anterior:
$matchfiltros para tres películas específicas.$addFieldscon$firstcrea un nuevo campotopBilledActorque contiene el primer elemento del arreglocast.$projectincluye solo los campostitle,castytopBilledActoren la salida.$sortordena los resultados por título.