Definición
$medianNuevo en la versión 7.0.
Devuelve la mediana (50º percentil) de un arreglo de valores numéricos.
Nota
Desambiguación
Esta página describe $median cuando se utiliza como expresión, que calcula la mediana de un arreglo de valores.
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 (window function), utilizado en la etapa$setWindowFieldspara devolver el valor de la mediana de los documentos de una ventana.
Sintaxis
{ $median: { input: <expression>, method: <string> }}Campos de comandos
Campo | Tipo | Necesidad | Descripción |
|---|---|---|---|
| Arreglo | Requerido | Puede ser cualquiera de los siguientes:
|
| String | Requerido | El método que MongoDB utiliza para calcular la mediana. El método debe ser |
Comportamiento
Cuando $median se utiliza como expresión, siempre utiliza un algoritmo de cálculo de percentiles preciso en lugar de uno aproximado, incluso cuando se especifica method: "approximate".
Esto se debe a que las expresiones operan sobre arreglos de tamaño limitado donde es aceptable mantener todos los valores de entrada en la memoria.
Ejemplo
El siguiente ejemplo utiliza una colección testScores para demostrar la forma de entrada de arreglo de $median.
Crear la colección testScores:
db.testScores.insertMany( [ { studentId: "2345", scores: [ 62, 81, 80, 75, 68 ] }, { studentId: "2356", scores: [ 60, 83, 79, 72, 65 ] }, { studentId: "2358", scores: [ 67, 82, 78, 70, 84 ] }, { studentId: "2367", scores: [ 64, 72, 77, 58, 91 ] }, { studentId: "2369", scores: [ 60, 53, 72, 85, 63 ] }] )El siguiente pipeline utiliza $median para calcular la mediana de la puntuación de la prueba para cada estudiante:
db.testScores.aggregate( [ { $project: { _id: 0, studentId: 1, testMedians: { $median: { input: "$scores", method: 'approximate' } } } }] )En el pipeline anterior:
$projectcon$medianencuentra el valor de la mediana en el arregloscorespara cada documento y lo devuelve comotestMedians.Cada resultado refleja la puntuación mediana de todas las puntuaciones de las pruebas registradas de dicho estudiante.