Definición
Devuelve uno o más valores de percentil calculados sobre un arreglo de números.
Nota
Desambiguación
Esta página describe $percentile cuando se utiliza como expresión, que calcula valores de percentil sobre un arreglo de valores de entrada.
También puede usar $percentile en estos otros contextos:
$percentile (accumulator), que devuelve valores de percentil agregando en un grupo de documentos de entrada.$percentile (window function), que se utiliza en la$setWindowFieldsetapa para devolver un arreglo de valores de percentil para documentos en una ventana particular.
Sintaxis
{ $percentile: { input: <expression>, p: [ <expression1>, <expression2>, ... ], method: <string> }}opciones
Campo | Tipo | Descripción |
|---|---|---|
| Arreglo | Puede ser cualquiera de los siguientes:
|
| expresión |
|
| String | El método que MongoDB utiliza para calcular el valor del percentil. El método debe ser |
Comportamiento
Cuando se utiliza como expresión, $percentile 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
Cree una 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 $percentile para calcular las puntuaciones de las pruebas de los percentiles 25, 50y 75para cada estudiante:
db.testScores.aggregate( [ { $project: { _id: 0, studentId: 1, testPercentiles: { $percentile: { input: "$scores", p: [ 0.25, 0.5, 0.75 ], method: 'approximate' } } } }] )En el pipeline anterior, $project con $percentile calcula los percentiles 25º, 50º y 75º del arreglo scores de cada estudiante y los devuelve como testPercentiles.