/ /

$mediana (función de ventana)

Definición

$median: Nuevo en la versión 7.0.

Devuelve el valor mediano (percentil 50) de los documentos en una ventana especificada. Puede usar $median tanto en ventanas basadas en documentos como en ventanas basadas en rangos.

Nota

Desambiguación

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

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

$median (accumulator), utilizado en la agrupación para devolver el valor medio de un grupo de documentos de entrada.
$median (expression), que devuelve la mediana de una matriz de valores.

Sintaxis

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $median: {
               input: <expression>,
               method: <string>
            }
         }
      }
   }
}

Campos de comandos

Campo	Tipo	Necesidad	Descripción
`input`	expresión	Requerido	Devuelve los valores sobre los que se calcula la mediana. `input` debe ser una expresión que dé como resultado un número. Si la expresión no da como resultado un número, el cálculo de `$median` ignora ese valor.
`method`	String	Requerido	El método que `mongod` utiliza para calcular el valor mediano. El método debe ser `'approximate'`.

Comportamiento

Consideraciones de cálculo

Cuando $median se utiliza como función de ventana, siempre utiliza un algoritmo de cálculo de percentiles preciso en lugar de uno aproximado, incluso cuando se especifica method: "approximate".

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 calcular la calificación mediana de IMDb para cada película que pertenece a los tres géneros: Aventura, Comedia y Drama. El período abarca el año anterior, el mismo año y el año siguiente (rango [ -1, 1 ]):

db.movies.aggregate( [
   {
      $match: {
         genres: { $all: ["Adventure", "Comedy", "Drama"] },
         year: { $gte: 2000, $lte: 2005 }
      }
   },
   {
      $setWindowFields: {
         sortBy: { year: 1 },
         output: {
            medianRatingByYear: {
               $median: {
                  input: "$imdb.rating",
                  method: "approximate"
               },
               window: { range: [ -1, 1 ] }
            }
         }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         year: 1,
         genres: 1,
         "imdb.rating": 1,
         medianRatingByYear: 1
      }
   },
   { $sort: { year: 1, "imdb.rating": -1 } },
   { $limit: 10 }
] )

[
  {
    genres: [ 'Adventure', 'Comedy', 'Drama' ],
    title: 'Thomas and the Magic Railroad',
    year: 2000,
    imdb: { rating: 3.5 },
    medianRatingByYear: 5.9
  },
  {
    imdb: { rating: 7.7 },
    year: 2001,
    genres: [ 'Adventure', 'Comedy', 'Drama' ],
    title: 'Y Tu Mamè Tambièn',
    medianRatingByYear: 5.9
  },
  {
    genres: [ 'Adventure', 'Comedy', 'Drama' ],
    title: 'Joe Dirt',
    year: 2001,
    imdb: { rating: 5.9 },
    medianRatingByYear: 5.9
  },
  {
    genres: [ 'Adventure', 'Comedy', 'Drama' ],
    title: 'Interstate 60: Episodes of the Road',
    year: 2002,
    imdb: { rating: 7.7 },
    medianRatingByYear: 7.1
  },
  {
    genres: [ 'Adventure', 'Comedy', 'Drama' ],
    title: 'Love is God',
    year: 2003,
    imdb: { rating: 8.9 },
    medianRatingByYear: 7.3
  },
  {
    imdb: { rating: 7.1 },
    year: 2003,
    genres: [ 'Adventure', 'Comedy', 'Drama' ],
    title: 'Holes',
    medianRatingByYear: 7.3
  },
  {
    genres: [ 'Adventure', 'Comedy', 'Drama' ],
    title: 'Grimm',
    year: 2003,
    imdb: { rating: 6.3 },
    medianRatingByYear: 7.3
  },
  {
    imdb: { rating: 7.3 },
    year: 2004,
    genres: [ 'Adventure', 'Comedy', 'Drama' ],
    title: 'The Life Aquatic with Steve Zissou',
    medianRatingByYear: 6.7
  },
  {
    genres: [ 'Adventure', 'Comedy', 'Drama' ],
    title: 'Transamerica',
    year: 2005,
    imdb: { rating: 7.5 },
    medianRatingByYear: 6.7
  },
  {
    imdb: { rating: 6.7 },
    year: 2005,
    genres: [ 'Adventure', 'Comedy', 'Drama' ],
    title: 'Lassie',
    medianRatingByYear: 6.7
  }
]

En el pipeline anterior:

$match Filtros para películas que pertenecen a los tres géneros de Aventura, Comedia y Drama, estrenadas entre 2000 y 2005.
$setWindowFields ordena por year en orden ascendente y aplica $median con una ventana basada en rango de [ -1, 1 ]. El medianRatingByYear de cada película es la mediana imdb.rating de las películas en los tres géneros estrenadas dentro de un año de su estreno.
$project incluye solo los campos title, year, genres, imdb.rating y medianRatingByYear.
$sort ordena los resultados por year en orden ascendente y luego por imdb.rating en orden descendente.
$limit Restringe la salida a los resultados 10 para mejorar la legibilidad.

Obtén más información

Volver

$maxN

$mergeObjects