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.

$median (función de ventana)

$median

Nuevo en la versión 7.0.

Devuelve el valor de la mediana (50percentil) de los documentos en una ventana especificada. Puede utilizar $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 puede usar $median en estos otros contextos:

{ $setWindowFields: { ... output: { <field>: { $median: { input: <expression>, method: <string> } } } }}
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 devuelva un número. Si la expresión no se evalúa como un número, el cálculo $median ignora ese valor.

method

String

Requerido

El método que mongod utiliza para calcular el valor de la mediana. El método debe ser 'approximate'.

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".

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 la implementación autogestionada de MongoDB, consultar Cargar el conjunto de datos de muestra. Si realizó alguna modificación en las bases de datos de muestra, es posible que deba descartar y volver a crear las bases de datos para ejecutar los ejemplos de esta página.

Este ejemplo utiliza $setWindowFields para calcular la mediana de la calificación de IMDb para cada película que pertenece a los tres géneros de aventura, comedia y drama. La ventana 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 }] )

En el pipeline anterior:

  • $match filtro 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 de los tres géneros estrenadas en el plazo de un año desde su estreno.

  • $project incluye solo los campos title, year, genres, imdb.rating y medianRatingByYear.

  • $sort clasifica los resultados por year en orden ascendente y, luego, por imdb.rating en orden descendente.

  • $limit restringe la salida a 10 resultados para mejorar la legibilidad.

Documentación