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.

$first (expresión)

$first

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: <expression> }

El <expression> debe evaluarse como un arreglo.

  • Si la expresión del operando se evalúa como un arreglo, $first devuelve el primer elemento de ese arreglo.

  • Si el arreglo está vacío, $first devuelve null.

  • Si la expresión se evalúa en null o hace referencia a un campo que falta, $first devuelve 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.

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:

  • $match filtros para tres películas específicas.

  • $addFields con $first crea un nuevo campo topBilledActor que contiene el primer elemento del arreglo cast.

  • $project incluye solo los campos title, cast y topBilledActor en la salida.

  • $sort ordena los resultados por título.