/ /

$firstN (operador de acumulación)

Definición

$firstN

Devuelve una agregación de los primeros n elementos de un grupo. Los resultados solo son válidos si los datos de entrada a la etapa de agrupación tienen un orden de clasificación definido. Si el grupo contiene menos de n elementos, $firstN devuelve todos los elementos del grupo.

El acumulador $firstN está disponible en estas etapas:

Nota

Desambiguación

Esta página describe $firstN cuando se utiliza como acumulador. Los acumuladores devuelven un único valor agregado, como la suma, el máximo o el mínimo, de un grupo de documentos de entrada.

También puedes usar $firstN en estos otros contextos:

$firstN (expression), que devuelve el número especificado de elementos desde el principio de una matriz.
$firstN (window function), que se utiliza en la etapa $setWindowFields para devolver los primeros n valores de los documentos en una ventana en particular.

Sintaxis

{
   $firstN:
      {
         input: <expression>,
         n: <expression>
      }
}

opciones

Campo	Tipo	Descripción
`input`	expresión	La expresión `input` se evalúa sobre cada documento del grupo de entrada y se conservan los primeros resultados `n`.
`n`	expresión	El número de elementos que `$firstN` devuelve del grupo. Para ver un ejemplo de cómo configurar `n` dinámicamente en función de la clave del grupo, consulte Configurar n en función de la clave del grupo.

Comportamiento

Valores nulos y faltantes

$firstN no filtra los valores nulos.
$firstN convierte los valores faltantes en null.

Comparación de $firstN y $topN

Tanto los acumuladores $firstN como los $topN pueden lograr resultados similares.

En general:

Si los documentos que ingresan a $group ya están ordenados, debes usar $firstN.
Si está clasificando y seleccionando los n elementos principales, entonces puede usar $topN para lograr ambas tareas con un solo acumulador.

Ejemplos

Los ejemplos de esta página utilizan la colección movies del conjunto de datos de ejemplo sample_mflix. Para aprender a cargar el conjunto de datos de ejemplo en su implementación de MongoDB, consulte Importar datos de ejemplo en su implementación de Atlas.

Encuentra las tres primeras películas de un mismo género.

Puedes usar el acumulador $firstN para encontrar las tres primeras películas de un mismo género.

db.movies.aggregate( [
   {
      $match: { genres: "Horror" }
   },
   {    
      $sort: { year: 1 }
   },
   {
      $group:
         {
            _id: "Horror",
            firstThreeMovies:
               {
                  $firstN:
                  {
                     input: [ "$title", "$year" ],
                     n: 3
                  }
               }
         }
   }
] )

[
  {
    _id: 'Horror',
    firstThreeMovies: [
      [ 'Dr. Jekyll and Mr. Hyde', 1931 ],
      [ 'Dracula', 1931 ],
      [ 'The Black Cat', 1934 ]
    ]
  }
]

La tubería precedente:

Utiliza $match para filtrar los resultados a películas donde Horror está incluido en el array genres.
Ordena los resultados por year en orden ascendente.
Agrupa todos los documentos resultantes en un único grupo.
Especifica los campos que son datos para $firstN con input : ["$title", "$year"].
Utiliza $firstN para devolver los tres primeros documentos del género Horror con n: 3.

Encuentra las tres primeras películas de diversos géneros.

Puedes usar el acumulador $firstN para encontrar los primeros n campos de entrada en cada género.

db.movies.aggregate( [
   {
      $unwind: "$genres"
   },
   {
      $sort: { year: 1 }
   },
   {
      $group:
         {
            _id: "$genres",
            movies:
               {
                  $firstN:
                     {
                        input: [ "$title", "$year" ],
                        n: 3
                     }
               }
         }
   },
   { $sort: { _id: 1 } },
   { $limit: 5 }
] )

[
  {
    _id: 'Action',
    movies: [
      [ 'The Perils of Pauline', 1914 ],
      [ 'From Hand to Mouth', 1919 ],
      [ "For Heaven's Sake", 1926 ]
    ]
  },
  {
    _id: 'Adventure',
    movies: [
      [ 'Robin Hood', 1922 ],
      [ 'Peter Pan', 1924 ],
      [ 'The Thief of Bagdad', 1924 ]
    ]
  },
  {
    _id: 'Animation',
    movies: [
      [
        'Winsor McCay, the Famous Cartoonist of the N.Y. Herald and His Moving Comics',
        1911
      ],
      [
        'Winsor McCay, the Famous Cartoonist of the N.Y. Herald and His Moving Comics',
        1911
      ],
      [ 'Gertie the Dinosaur', 1914 ]
    ]
  },
  {
    _id: 'Biography',
    movies: [ [ 'Regeneration', 1915 ], [ 'Salomè', 1922 ], [ 'Napoleon', 1927 ] ]
  },
  {
    _id: 'Comedy',
    movies: [
      [
        'Winsor McCay, the Famous Cartoonist of the N.Y. Herald and His Moving Comics',
        1911
      ],
      [
        'Winsor McCay, the Famous Cartoonist of the N.Y. Herald and His Moving Comics',
        1911
      ],
      [ 'Gertie the Dinosaur', 1914 ]
    ]
  }
]

La tubería precedente:

Utiliza $unwind para crear un documento separado para cada género en el array genres.
Ordena los resultados por year en orden ascendente.
Utiliza $group para agrupar los resultados por genres.
Utiliza $firstN para devolver los tres primeros documentos de cada género con n: 3.
Especifica los campos que son datos para $firstN con input : ["$title", "$year"].
Limita la salida a cinco documentos para mejorar la legibilidad.

Establecer n en función de la clave de grupo.

Puede asignar el valor de n dinámicamente en función de la clave de grupo. En este ejemplo, la expresión $cond utiliza el campo rated para cambiar el valor de n:

db.movies.aggregate([
   { $match: { rated: { $in: ["G", "PG", "PG-13", "R"] } } },
   { $sort: { title: 1 } },
   {
      $group:
         {
            _id: {"rated": "$rated"},
            movies:
               {
                  $firstN:
                     {
                        input: "$title",
                        n: { $cond: { if: { $eq: ["$rated", "PG"] }, then: 3, else: 1 } }
                     }
               }
         }
   }
] )

[
  { _id: { rated: 'PG-13' }, movies: [ "'night, Mother" ] },
  {
    _id: { rated: 'PG' },
    movies: [ '*batteries not included', '...And God Created Woman', '1776' ]
  },
  { _id: { rated: 'G' }, movies: [ '101 Dalmatians' ] },
  { _id: { rated: 'R' }, movies: [ '$' ] }
]

La tubería precedente:

Filtros para películas con calificaciones de G, PG, PG-13 o R.
Ordena los resultados alfabéticamente por title.
Agrupa las películas por rated (la calificación de la película).
Utiliza la expresión $cond para devolver las películas 3 para las películas con calificación PG y la película 1 para todas las demás calificaciones.

En la salida, la calificación PG devuelve 3 películas, mientras que las calificaciones G, PG-13 y R devuelven cada una 1 película.

Obtén más información

Volver

$first

último