Definición
$percentileNuevo en la versión 7.0.
Devuelve un arreglo de valores escalares que corresponden a los valores de percentil especificados.
Disponible en estas etapas:
Nota
Desambiguación
Esta página describe
$percentilecuando se utiliza como acumulador. Los acumuladores devuelven un valor agregado en un grupo de documentos de entrada.También puede usar
$percentileen estos otros contextos:$percentile (expression), que calcula valores de percentil sobre un arreglo de valores 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
$percentile requiere los siguientes campos:
Campo | Tipo | Necesidad | Descripción |
|---|---|---|---|
| expresión | Requerido |
|
| expresión | Requerido |
|
| String | Requerido | El método que MongoDB utiliza para calcular el valor del percentil. El método debe ser |
Comportamiento
Cuando se utiliza como un acumulador, $percentile:
Calcula un conjunto de percentiles por grupo, agregado de todos los documentos del grupo.
Utiliza el t-digest algoritmo para calcular percentiles aproximados. Es necesaria la aproximación para calcular percentiles utilizando una estructura de datos de tamaño limitado.
Consideraciones de cálculo
Cuando se utiliza como un acumulador, $percentile siempre utiliza un algoritmo de aproximación. Debido a la pseudorandomicidad en el algoritmo de aproximación t-digest, los valores de percentil calculados en el mismo conjunto de datos podrían diferir en cada ejecución. Además, $percentile puede devolver valores que difieren ligeramente de los verdaderos percentiles estadísticos.
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.
Calcular percentiles de puntuación por género
El siguiente ejemplo utiliza el acumulador $percentile para calcular los percentiles 50y 90de las calificaciones de IMDB para películas de los géneros Action y Drama:
db.movies.aggregate( [ { $unwind: "$genres" }, { $match: { genres: { $in: [ "Action", "Drama" ] }, "imdb.rating": { $exists: true } } }, { $group: { _id: "$genres", ratingPercentiles: { $percentile: { input: "$imdb.rating", p: [ 0.5, 0.9 ], method: "approximate" } } } }, { $sort: { _id: 1 } }] )El pipeline anterior:
Utiliza
$unwindpara crear un documento independiente para cada género en el arreglogenres.Utiliza
$matchpara filtro de películas que están clasificadas comoActionoDramay tienen un campo de calificación de IMDB.Agrupa películas por género.
Utiliza
$percentilepara calcular el percentil 50y 90de las calificaciones de IMDB para cada género conp: [0.5, 0.9].Utiliza
$sortpara ordenar la salida por nombre de género.
El arreglo de salida ratingPercentiles contiene dos valores: el percentil 50y el percentil 90de la calificación IMDB para cada género.