Definición
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:
$median (accumulator), que se utiliza en la agrupación para devolver la mediana en un grupo de documentos de entrada.$median (expression), que devuelve la mediana de un arreglo de valores.
Sintaxis
{ $setWindowFields: { ... output: { <field>: { $median: { input: <expression>, method: <string> } } } }}Campos de comandos
Campo | Tipo | Necesidad | Descripción |
|---|---|---|---|
| expresión | Requerido | Devuelve los valores sobre los que se calcula la mediana. |
| String | Requerido | El método que |
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 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:
$matchfiltro para películas que pertenecen a los tres géneros de Aventura, Comedia y Drama, estrenadas entre 2000 y 2005.$setWindowFieldsordena poryearen orden ascendente y aplica$mediancon una ventana basada en rango de[ -1, 1 ]. ElmedianRatingByYearde cada película es la medianaimdb.ratingde las películas de los tres géneros estrenadas en el plazo de un año desde su estreno.$projectincluye solo los campostitle,year,genres,imdb.ratingymedianRatingByYear.$sortclasifica los resultados poryearen orden ascendente y, luego, porimdb.ratingen orden descendente.$limitrestringe la salida a 10 resultados para mejorar la legibilidad.