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.

$percentil (función de ventana)

$percentile

Devuelve un arreglo de valores de percentil para los percentiles especificados dentro de una ventana.

Nota

Desambiguación

Esta página describe $percentile cuando se utiliza como función de ventana.

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

{ $setWindowFields: { ... output: { <field>: { $percentile: { input: <expression>, p: [ <expression1>, <expression2>, ... ], method: <string> }, } } }}
Campo
Tipo
Descripción

input

expresión

El campo sobre el que $percentile calcula los valores de percentil. 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

$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

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

En $setWindowFields, $percentile devuelve un resultado para cada documento, pero los resultados se calculan sobre una ventana de documentos.

Cuando se utiliza como función de ventana, $percentile siempre utiliza un algoritmo de cálculo de percentiles preciso en lugar de uno aproximado, incluso cuando se especifica method: 'approximate'.

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 $percentile en una etapa $setWindowFields para encontrar películas de acción en el 10% superior de las calificaciones de IMDB para cada año desde 2002 hasta 2004.

db.movies.aggregate( [ { $match: { year: { $in: [ 2002, 2003, 2004 ] }, genres: "Action", "imdb.votes": { $gte: 5000 }, } }, { $setWindowFields: { partitionBy: "$year", output: { top10PctRatingForYear: { $percentile: { input: "$imdb.rating", p: [ 0.9 ], method: "approximate" }, window: { documents: [ "unbounded", "unbounded" ] } } } } }, { $match: { $expr: { $gte: [ "$imdb.rating", { $arrayElemAt: [ "$top10PctRatingForYear", 0 ] } ] } } }, { $project: { _id: 0, title: 1, year: 1, imdb_rating: "$imdb.rating", top10PctRatingForYear: 1 } }, { $sort: { year: 1, imdb_rating: -1 } }] )

El pipeline anterior:

  • Utiliza $match como filtro para películas de acción estrenadas en 2002, 2003 o 2004 con al menos 5,000 votos de IMDB.

  • Utiliza $setWindowFields para particionar películas por year. Dentro de cada partición, el operador $percentile calcula el percentil 90de la calificación IMDB utilizando p: [0.9] y una ventana ilimitada, almacenado en top10PctRatingForYear.

  • Utiliza $match con $expr para filtrar películas cuya calificación de IMDB sea mayor o igual que la calificación del percentil 90para su año.

  • Utiliza $project para incluir los campos title, year, imdb_rating y top10PctRatingForYear en la salida.

  • Utiliza $sort para ordenar los resultados por año de forma ascendente y luego por calificación de IMDB de forma descendente.

Califique esta página

Documentación