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.

$firstN (operador de acumulación)

$firstN

Devuelve una agregación de los primeros n elementos de un grupo. Los resultados son significativos solo si los datos de entrada de 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 en un grupo de documentos de entrada.

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

{ $firstN: { input: <expression>, n: <expression> }}
Campo
Tipo
Descripción

input

expresión

La expresión input se evalúa en cada documento del grupo de entrada y se conservan los primeros n resultados.

n

expresión

El número de elementos que $firstN devuelve del grupo. Para ver un ejemplo de configuración dinámica de n basado en la clave de grupo, consulte Establecer n basado en la clave de grupo.

  • $firstN no filtra los valores nulos.

  • $firstN convierte los valores faltantes en null.

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.

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

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

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

El pipeline anterior:

  • Utiliza $match para filtrar los resultados a las películas donde Horror está incluido en el arreglo 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 para el género Horror con n: 3.

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

El pipeline anterior:

  • Utiliza $unwind para crear un documento independiente para cada género en el arreglo 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 para 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.

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

El pipeline anterior:

  • 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 3 películas para las que tienen calificación PGy 1 película 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 1 película cada una.