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.

$percentile (operador de acumulación)

$percentile

Nuevo 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 $percentile cuando se utiliza como acumulador. Los acumuladores devuelven un valor agregado en un grupo de documentos de entrada.

También puede usar $percentile en estos otros contextos:

{ $percentile: { input: <expression>, p: [ <expression1>, <expression2>, ... ], method: <string> }}

$percentile requiere los siguientes campos:

Campo
Tipo
Necesidad
Descripción

input

expresión

Requerido

$percentile calcula los valores de percentil de estos datos. input debe ser una expresión que se evalúe como un tipo numérico. Si la expresión no se evalúa como un tipo numérico, el cálculo $percentile ignora ese valor.

p

expresión

Requerido

$percentile calcula un valor de percentil para cada elemento en p. Estos elementos especifican los cuantiles a calcular y deben ser valores numéricos en el rango de 0.0 a 1.0, ambos incluidos.

$percentile devuelve resultados en el mismo orden que los elementos en p.

method

String

Requerido

El método que MongoDB utiliza para calcular el valor del percentil. El método debe ser 'approximate'.

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.

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.

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.

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 $unwind para crear un documento independiente para cada género en el arreglo genres.

  • Utiliza $match para filtro de películas que están clasificadas como Action o Drama y tienen un campo de calificación de IMDB.

  • Agrupa películas por género.

  • Utiliza $percentile para calcular el percentil 50y 90de las calificaciones de IMDB para cada género con p: [0.5, 0.9].

  • Utiliza $sort para 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.

Califique esta página