/ /

$firstN (función de ventana)

Definición

$firstN

Devuelve una matriz que contiene los primeros n elementos dentro de una ventana.

Nota

Desambiguación

Esta página describe $firstN cuando se utiliza como función de ventana.

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

$firstN (accumulator), utilizado en la agrupación para devolver los primeros n elementos de cada grupo.
$firstN (expression), que devuelve el número especificado de elementos desde el principio de una matriz.

Sintaxis

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $firstN: {
               input: <expression>,
               n: <expression>
            }
         }
      }
   }
}

opciones

Campo	Tipo	Descripción
`input`	expresión	La expresión `input` se evalúa sobre cada documento en la ventana y se conservan los primeros resultados `n`.
`n`	expresión	El número de elementos que `$firstN` devuelve desde la ventana. Debe ser un número entero positivo. Si la ventana contiene menos de `n` elementos, `$firstN` devuelve todos los elementos de la ventana.

Comportamiento

Valores nulos y faltantes

$firstN no filtra los valores nulos.
$firstN convierte los valores faltantes en 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.

Este ejemplo utiliza $setWindowFields para particionar las películas por year, ordenarlas por imdb.rating en orden descendente y devolver las tres primeras películas de cada año. Cada película también incluye un campo que muestra los tres títulos de películas mejor valorados estrenados en ese año:

db.movies.aggregate( [
   {
      $match: {
         year: { $in: [ 1999, 2000, 2001 ] },
         "imdb.rating": { $gte: 8.5 }
      }
   },
   {
      $setWindowFields: {
         partitionBy: "$year",
         sortBy: { "imdb.rating": -1 },
         output: {
            topThreeMoviesInYear: {
               $firstN: {
                  input: "$title",
                  n: 3
               },
               window: {
                  documents: [ "unbounded", "unbounded" ]
               }
            }
         }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         year: 1,
         "imdb.rating": 1,
         topThreeMoviesInYear: 1
      }
   },
   {
      $sort: { year: 1, "imdb.rating": -1 }
   }
] )

[
  {
    imdb: { rating: 8.9 },
    year: 1999,
    title: 'Fight Club',
    topThreeMoviesInYear: [ 'Fight Club', 'The Matrix', 'Eddie Izzard: Dress to Kill' ]
  },
  {
    imdb: { rating: 8.7 },
    year: 1999,
    title: 'The Matrix',
    topThreeMoviesInYear: [ 'Fight Club', 'The Matrix', 'Eddie Izzard: Dress to Kill' ]
  },
  {
    title: 'Eddie Izzard: Dress to Kill',
    year: 1999,
    imdb: { rating: 8.7 },
    topThreeMoviesInYear: [ 'Fight Club', 'The Matrix', 'Eddie Izzard: Dress to Kill' ]
  },
  {
    imdb: { rating: 8.5 },
    year: 1999,
    title: 'The Green Mile',
    topThreeMoviesInYear: [ 'Fight Club', 'The Matrix', 'Eddie Izzard: Dress to Kill' ]
  },
  {
    imdb: { rating: 8.5 },
    year: 2000,
    title: 'Gladiator',
    topThreeMoviesInYear: [ 'Gladiator', 'Memento', 'Hera Pheri' ]
  },
  {
    imdb: { rating: 8.5 },
    year: 2000,
    title: 'Memento',
    topThreeMoviesInYear: [ 'Gladiator', 'Memento', 'Hera Pheri' ]
  },
  {
    title: 'Hera Pheri',
    year: 2000,
    imdb: { rating: 8.5 },
    topThreeMoviesInYear: [ 'Gladiator', 'Memento', 'Hera Pheri' ]
  },
  {
    title: "A Dog's Will",
    year: 2000,
    imdb: { rating: 8.5 },
    topThreeMoviesInYear: [ 'Gladiator', 'Memento', 'Hera Pheri' ]
  },
  {
    title: 'Band of Brothers',
    year: 2001,
    imdb: { rating: 9.6 },
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  },
  {
    title: 'The Blue Planet',
    year: 2001,
    imdb: { rating: 9.2 },
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  },
  {
    imdb: { rating: 8.8 },
    year: 2001,
    title: 'The Lord of the Rings: The Fellowship of the Ring',
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  },
  {
    imdb: { rating: 8.6 },
    year: 2001,
    title: 'Spirited Away',
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  },
  {
    title: 'Promises',
    year: 2001,
    imdb: { rating: 8.5 },
    topThreeMoviesInYear: [
      'Band of Brothers',
      'The Blue Planet',
      'The Lord of the Rings: The Fellowship of the Ring'
    ]
  }
]

La tubería precedente:

Utiliza la etapa $match para filtrar los resultados a películas estrenadas entre los años 1999 y 2001 con una calificación IMDb de 8.5 o superior.
Utiliza $setWindowFields para particionar las películas por year y ordenarlas por imdb.rating en orden descendente. La etapa utiliza $firstN con n: 3 para crear topThreeMoviesInYear a partir de una ventana definida como documents: [ "unbounded", "unbounded" ].
Utiliza $project para incluir solo los campos title, year, imdb.rating y topThreeMoviesInYear en la salida.
Utiliza $sort para ordenar los resultados por año y calificación.

Volver

$first

último