/ /

$top (función de ventana)

Definición

$top

Devuelve el elemento superior dentro de una ventana según el orden de clasificación especificado.

Nota

Desambiguación

Esta página describe $top cuando se usa como función de ventana. También puede usar $top en estos otros contextos:

$top (expression operator), que devuelve el elemento superior de una matriz según un orden de clasificación especificado.
$top (accumulator), que devuelve el elemento superior dentro de un grupo según el orden de clasificación especificado.

Sintaxis

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

Campo	Necesidad	Descripció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.
salida	Requerido	Especifica la salida para cada elemento de la ventana. Puede ser cualquier expresión.

Comportamiento

La función de ventana $top tiene los siguientes comportamientos para valores nulos y faltantes:

$top no filtra los valores nulos.
$top 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 la película mejor valorada del año a través de una ventana.

Este ejemplo utiliza $top como función de ventana para identificar la película mejor valorada del mismo año para cada documento de película. El conjunto de datos se filtra para incluir solo películas familiares con clasificación PG de 1980–1982.

db.movies.aggregate( [
   {
      $match: {
         year: { $in: [ 1980, 1981, 1982 ] },
         "imdb.rating": { $exists: true, $ne: null },
         genres: "Family",
         rated: "PG"
      }
   },
   {
      $setWindowFields: {
         partitionBy: "$year",
         output: {
            highestRatedInYear: {
               $top: {
                  output: { title: "$title", rating: "$imdb.rating" },
                  sortBy: { "imdb.rating": -1 }
               },
               window: {
                  documents: [ "unbounded", "unbounded" ]
               }
            }
         }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         year: 1,
         rating: "$imdb.rating",
         highestRatedInYear: 1
      }
   },
   {
      $limit: 10
   }
] )

[
  {
    title: 'My Bodyguard',
    year: 1980,
    highestRatedInYear: { title: 'My Bodyguard', rating: 7 },
    rating: 7
  },
  {
    title: 'Popeye',
    year: 1980,
    highestRatedInYear: { title: 'My Bodyguard', rating: 7 },
    rating: 5.2
  },
  {
    title: 'The Watcher in the Woods',
    year: 1980,
    highestRatedInYear: { title: 'My Bodyguard', rating: 7 },
    rating: 6.5
  },
  {
    title: 'Clash of the Titans',
    year: 1981,
    highestRatedInYear: { title: 'Clash of the Titans', rating: 6.9 },
    rating: 6.9
  },
  {
    title: 'Going Ape!',
    year: 1981,
    highestRatedInYear: { title: 'Clash of the Titans', rating: 6.9 },
    rating: 3.6
  },
  {
    title: 'Night Crossing',
    year: 1982,
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 6.4
  },
  {
    year: 1982,
    title: 'Annie',
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 6.5
  },
  {
    title: 'Author! Author!',
    year: 1982,
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 6.1
  },
  {
    title: 'The Dark Crystal',
    year: 1982,
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 7.2
  },
  {
    year: 1982,
    title: 'E.T. the Extra-Terrestrial',
    highestRatedInYear: { title: 'E.T. the Extra-Terrestrial', rating: 7.9 },
    rating: 7.9
  }
]

En este ejemplo:

La etapa $match filtra las películas familiares con clasificación PG de 1980-1982 para producir un conjunto de resultados pequeño y específico.
$setWindowFields divide los documentos por year.
La ventana abarca desde unbounded hasta unbounded, lo que significa que $top considera todos los documentos en la partición al determinar la película mejor calificada.
$top Devuelve la película mejor valorada en cada partición como un documento incrustado que contiene los campos title y rating.
$project incluye solo los campos title, year, rating y highestRatedInYear en la salida.
$limit limita la salida a documentos 10.

Este método conserva todos los documentos individuales de las películas e incluye una referencia a la película más taquillera de cada año.

Volver

$sum

$topN