Quantil(), Quantils() (Aggregationsfunktion)

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. Die Genauigkeit hängt von der Bevölkerungsdichte in der Region des Perzentils ab.

percentiles() funktioniert ähnlich wie percentile(). percentiles() Kann jedoch mehrere Quantilwerte gleichzeitig berechnen, was effizienter ist als die Berechnung jedes Quantilwerts separat.

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

Die Beispiele in diesem Abschnitt zeigen, wie Sie die Syntax verwenden, um Ihnen den Einstieg zu erleichtern.

Berechnen eines einzelnen Quantils

Das folgende Beispiel zeigt den Wert, der DamageProperty größer als 95 % des Beispielsatzes und kleiner als 5 % des Beispielsatzes ist.

StormEvents | summarize percentile(DamageProperty, 95) by State

Output

Die angezeigte Ergebnistabelle enthält nur die ersten 10 Zeilen.

Berechnen mehrerer Quantils

Das folgende Beispiel zeigt den Wert der DamageProperty gleichzeitigen Berechnung mit 5, 50 (Median) und 95.

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

Output

Die angezeigte Ergebnistabelle enthält nur die ersten 10 Zeilen.

Zurückgeben von Quantilen als Array

Statt die Werte in einzelnen Spalten zurückzugeben, verwenden Sie die percentiles_array() Funktion, um die Quantile in einer einzelnen Spalte des dynamischen Arraytyps zurückzugeben.

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

In der Ergebnistabelle werden nur die ersten 10 Zeilen angezeigt.

Dynamisches Array von Quantilen

Quantile für percentiles_array können in einem dynamischen Array mit ganzzahligen oder Gleitkommazahlen angegeben werden. Das Array muss konstant sein, muss aber nicht literal sein.

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

Output

In der Ergebnistabelle werden nur die ersten 10 Zeilen angezeigt.

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.

Schätzungsfehler in Perzentilen

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

Related content

• Aggregationsfunktionstypen auf einen Blick
• Quantilw(), Quantilsw() (Aggregationsfunktion)
• avg function