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 (expresión)

$percentile

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: { input: <expression>, p: [ <expression1>, <expression2>, ... ], method: <string> }}
Campo
Tipo
Descripción

input

Arreglo

Puede ser cualquiera de los siguientes:

  • Una expresión que se resuelve en un arreglo. Por ejemplo, $scores, donde el campo del documento $scores contiene un arreglo de valores numéricos.

  • Un arreglo de expresiones, cada una de las cuales se evalúa como un valor numérico. Por ejemplo, [ "$field1", "$field2", "$field3" ].

$percentile calcula los valores de percentil en todos los valores numéricos del arreglo. Los valores no numéricos se ignoran.

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'.

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.

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.

Califique esta página