/ /

$primero (expresión)

Definición

$first

Devuelve el primer elemento de un array.

Nota

Desambiguación

Esta página describe $first cuando se usa como una expresión, que devuelve el primer elemento de una matriz.

También puedes 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 etapa $setWindowFields para devolver un valor para el primer documento en una ventana.

Sintaxis

{ $first: <expression> }

El <expression> debe evaluarse como un array.

Comportamiento

Si la expresión del operando se evalúa como una matriz, $first devuelve el primer elemento de esa matriz.
Si el array está vacío, $first devuelve null.
Si la expresión se evalúa como null o hace referencia a un campo faltante, $first devuelve 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 su implementación autogestionada de MongoDB, consulte Cargar el conjunto de datos de ejemplo. Si realizó alguna modificación en las bases de datos de ejemplo, es posible que deba eliminarlas y volver a crearlas para ejecutar los ejemplos de esta página.

El siguiente ejemplo utiliza $first para devolver el actor mejor acreditado de cada película. En el conjunto de datos sample_mflix, el array cast enumera a los actores en orden de acreditación, por lo que el primer elemento es el actor mejor acreditado:

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 } }
] )

[
  {
    title: 'Forrest Gump',
    cast: [ 'Tom Hanks', 'Rebecca Williams', 'Sally Field', 'Michael Conner Humphreys' ],
    topBilledActor: 'Tom Hanks'
  },
  {
    title: 'Pulp Fiction',
    cast: [ 'Tim Roth', 'Amanda Plummer', 'Laura Lovelace', 'John Travolta' ],
    topBilledActor: 'Tim Roth'
  },
  {
    title: 'The Godfather',
    cast: [ 'Marlon Brando', 'Al Pacino', 'James Caan', 'Richard S. Castellano' ],
    topBilledActor: 'Marlon Brando'
  }
]

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 array cast.
$project incluye solo los campos title, cast y topBilledActor en la salida.
$sort ordena los resultados por título.

Obtén más información

Volver

$filter

$firstN