percentile(), centiles() (fonction d’agrégation)

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 précision dépend de la densité de population dans la région du centile.

percentiles() fonctionne de la même façon que percentile(). Toutefois, percentiles() vous pouvez calculer plusieurs valeurs de centile à la fois, ce qui est plus efficace que le calcul de chaque valeur de centile séparément.

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

Les exemples de cette section montrent comment utiliser la syntaxe pour vous aider à commencer.

Calculer un centile unique

L’exemple suivant montre la valeur d’être DamageProperty supérieure à 95 % du jeu d’échantillons et inférieure à 5 % du jeu d’échantillons.

StormEvents | summarize percentile(DamageProperty, 95) by State

Output

Le tableau des résultats indiqué inclut uniquement les 10 premières lignes.

Calculer plusieurs centiles

L’exemple suivant montre la valeur de calcul simultanée à l’aide de DamageProperty 5, 50 (médiane) et 95.

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

Output

Le tableau des résultats indiqué inclut uniquement les 10 premières lignes.

Retourner des centiles sous forme de tableau

Au lieu de retourner les valeurs dans des colonnes individuelles, utilisez la percentiles_array() fonction pour renvoyer les centiles dans une seule colonne de type de tableau dynamique.

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

Le tableau des résultats affiche uniquement les 10 premières lignes.

Tableau dynamique de centiles

Les centiles peuvent percentiles_array être spécifiés dans un tableau dynamique de nombres entiers ou à virgule flottante. Le tableau doit être constant, mais ne doit pas être littéral.

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

Output

Le tableau des résultats affiche uniquement les 10 premières lignes.

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.

Erreur d’estimation dans les centiles

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

Related content

• types de fonctions d’agrégation en un clin d’œil
• percentilew(), percentilesw() (fonction d’agrégation)
• avg function