percentile(), percentiles() (función de agregación)

Applies to: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

The percentile() function calculates an estimate for the specified nearest-rank percentile of the population defined by expr. La precisión depende de la densidad de población en la región del percentil.

percentiles() funciona de forma similar a percentile(). Sin embargo, percentiles() puede calcular varios valores de percentil a la vez, lo que es más eficaz que calcular cada valor de percentil por separado.

To calculate weighted percentiles, see percentilesw().

Syntax

percentile( expr,percentile)

percentiles( expr,percentiles)

Learn more about syntax conventions.

Parameters

Returns

Returns a table with the estimates for expr of the specified percentiles in the group, each in a separate column.

Examples

Los ejemplos de esta sección muestran cómo usar la sintaxis para ayudarle a empezar.

Cálculo del percentil único

En el ejemplo siguiente se muestra el valor de DamageProperty ser mayor que el 95 % del conjunto de muestras y menor que el 5 % del conjunto de muestras.

StormEvents | summarize percentile(DamageProperty, 95) by State

Output

La tabla de resultados que se muestra incluye solo las primeras 10 filas.

Cálculo de varios percentiles

En el ejemplo siguiente se muestra el valor de DamageProperty calculado simultáneamente con 5, 50 (mediana) y 95.

StormEvents | summarize percentiles(DamageProperty, 5, 50, 95) by State

Output

La tabla de resultados que se muestra incluye solo las primeras 10 filas.

Devolver percentiles como una matriz

En lugar de devolver los valores en columnas individuales, use la percentiles_array() función para devolver los percentiles en una sola columna del tipo de matriz dinámica.

Syntax

percentiles_array( expr,percentiles)

Parameters

Returns

Returns an estimate for expr of the specified percentiles in the group as a single column of dynamic array type.

Examples

Comma-separated percentiles

Multiple percentiles can be obtained as an array in a single dynamic column, instead of in multiple columns as with percentiles().

TransformedSensorsData
| summarize percentiles_array(Value, 5, 25, 50, 75, 95), avg(Value) by SensorName

Output

La tabla de resultados muestra solo las primeras 10 filas.

Matriz dinámica de percentiles

Los percentiles para percentiles_array se pueden especificar en una matriz dinámica de números enteros o de punto flotante. La matriz debe ser constante, pero no tiene que ser literal.

TransformedSensorsData
| summarize percentiles_array(Value, dynamic([5, 25, 50, 75, 95])), avg(Value) by SensorName

Output

La tabla de resultados muestra solo las primeras 10 filas.

Nearest-rank percentile

P-th percentile (0 <P<= 100) of a list of ordered values, sorted in ascending order, is the smallest value in the list. The P percent of the data is less or equal to P-th percentile value (from Wikipedia article on percentiles).

Define 0-th percentiles to be the smallest member of the population.

Error de estimación en percentiles

The percentiles aggregate provides an approximate value using T-Digest.

Related content

• tipos de función Aggregation de un vistazo
• percentilew(), percentilesw() (función de agregación)
• avg function