/ /

$topN (función de ventana)

Definición

$topN

Devuelve los elementos n superiores dentro de una ventana particular, según el orden de clasificación especificado.

Nota

Otros usos de $topN

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

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

$topN (accumulator), que devuelve los n elementos superiores dentro de un grupo según el orden de clasificación especificado.
$topN (expression), que devuelve los n elementos superiores de una matriz.

Sintaxis

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $topN: {
               n: <expression>,
               output: <expression>,
               sortBy: {
                  <field1>: <sort order>,
                  <field2>: <sort order>, ...
               }
            }
         }
      }
   }
}

opciones

Campo	Necesidad	Descripción
`n`	Requerido	Número de resultados a devolver. Debe redondearse a un valor entero positivo. Si la ventana contiene menos de `n` elementos, `$topN` devuelve todos los elementos de la ventana.
`output`	Requerido	Determina la salida para cada documento en la ventana. Puede ser cualquier expresión.
`sortBy`	Requerido	Define el orden de clasificación de los elementos dentro de la ventana, con una sintaxis similar a `$sort`. No afecta el orden de los documentos en la salida del pipeline.

Comportamiento

Valores nulos y faltantes

$topN no filtra los valores nulos.
$topN 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.

Encuentra las tres películas mejor valoradas en una ventana

Este ejemplo utiliza $topN en $setWindowFields para devolver cada película con las tres películas mejor valoradas estrenadas en el mismo año.

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

[
  {
    imdb: { rating: 8.9 },
    year: 1999,
    title: 'Fight Club',
    topThreeRatedInYear: [
      { rating: 8.9, title: 'Fight Club' },
      { rating: 8.7, title: 'Eddie Izzard: Dress to Kill' },
      { rating: 8.7, title: 'The Matrix' }
    ]
  },
  {
    imdb: { rating: 8.7 },
    year: 1999,
    title: 'The Matrix',
    topThreeRatedInYear: [
      { rating: 8.9, title: 'Fight Club' },
      { rating: 8.7, title: 'Eddie Izzard: Dress to Kill' },
      { rating: 8.7, title: 'The Matrix' }
    ]
  },
  {
    title: 'Eddie Izzard: Dress to Kill',
    year: 1999,
    imdb: { rating: 8.7 },
    topThreeRatedInYear: [
      { rating: 8.9, title: 'Fight Club' },
      { rating: 8.7, title: 'Eddie Izzard: Dress to Kill' },
      { rating: 8.7, title: 'The Matrix' }
    ]
  },
  {
    imdb: { rating: 8.5 },
    year: 1999,
    title: 'The Green Mile',
    topThreeRatedInYear: [
      { rating: 8.9, title: 'Fight Club' },
      { rating: 8.7, title: 'Eddie Izzard: Dress to Kill' },
      { rating: 8.7, title: 'The Matrix' }
    ]
  },
  {
    title: 'Band of Brothers',
    year: 2001,
    imdb: { rating: 9.6 },
    topThreeRatedInYear: [
      { rating: 9.6, title: 'Band of Brothers' },
      { rating: 9.2, title: 'The Blue Planet' },
      {
        rating: 8.8,
        title: 'The Lord of the Rings: The Fellowship of the Ring'
      }
    ]
  },
  {
    title: 'The Blue Planet',
    year: 2001,
    imdb: { rating: 9.2 },
    topThreeRatedInYear: [
      { rating: 9.6, title: 'Band of Brothers' },
      { rating: 9.2, title: 'The Blue Planet' },
      {
        rating: 8.8,
        title: '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',
    topThreeRatedInYear: [
      { rating: 9.6, title: 'Band of Brothers' },
      { rating: 9.2, title: 'The Blue Planet' },
      {
        rating: 8.8,
        title: 'The Lord of the Rings: The Fellowship of the Ring'
      }
    ]
  },
  {
    imdb: { rating: 8.6 },
    year: 2001,
    title: 'Spirited Away',
    topThreeRatedInYear: [
      { rating: 9.6, title: 'Band of Brothers' },
      { rating: 9.2, title: 'The Blue Planet' },
      {
        rating: 8.8,
        title: 'The Lord of the Rings: The Fellowship of the Ring'
      }
    ]
  },
  {
    title: 'Promises',
    year: 2001,
    imdb: { rating: 8.5 },
    topThreeRatedInYear: [
      { rating: 9.6, title: 'Band of Brothers' },
      { rating: 9.2, title: 'The Blue Planet' },
      {
        rating: 8.8,
        title: 'The Lord of the Rings: The Fellowship of the Ring'
      }
    ]
  }
]

En el ejemplo precedente:

$match filtra películas estrenadas en 1999 o 2001 con una calificación IMDb de al menos 8.5.
$setWindowFields divide los documentos por year.
window: { documents: [ "unbounded", "unbounded" ] } abarca toda la partición del año, por lo que $topN considera todos los documentos del año al determinar las tres películas mejor calificadas.
$topN Utiliza sortBy: { "imdb.rating": -1, title: 1 } para clasificar las películas según su puntuación en IMDb y title como criterio de desempate. Todos los documentos del mismo año reciben el mismo valor topThreeRatedInYear.
$project Elimina los campos innecesarios para resaltar el resultado de la función de ventana.
$sort Ordena los resultados por año en orden ascendente y por calificación en orden descendente.

Volver

$top

Sesiones de servidor