percentile()、percentiles() (集計関数)

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. 精度は、パーセンタイル リージョンの人口密度によって異なります。

percentiles() は、 percentile()と同様に機能します。 ただし、 percentiles() では複数のパーセンタイル値を一度に計算できます。これは、各パーセンタイル値を個別に計算するよりも効率的です。

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

このセクションの例では、構文を使用して作業を開始する方法を示します。

単一パーセンタイルの計算

次の例は、 DamageProperty の値がサンプル セットの 95% を超え、サンプル セットの 5% 未満であることを示しています。

StormEvents | summarize percentile(DamageProperty, 95) by State

Output

表示される結果テーブルには、最初の 10 行のみが含まれます。

複数のパーセンタイルを計算する

次の例は、5、50 (中央値) と 95 を使用して同時に計算される DamageProperty の値を示しています。

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

Output

表示される結果テーブルには、最初の 10 行のみが含まれます。

パーセンタイルを配列として返す

個々の列の値を返す代わりに、 percentiles_array() 関数を使用して、動的配列型の単一列のパーセンタイルを返します。

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

結果テーブルには、最初の 10 行のみが表示されます。

パーセンタイルの動的配列

percentiles_arrayのパーセンタイルは、整数または浮動小数点数の動的配列で指定できます。 配列は、定数にする必要がありますが、リテラルにする必要はありません。

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

Output

結果テーブルには、最初の 10 行のみが表示されます。

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.

パーセンタイル単位の推定エラー

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

Related content

• 集計関数の種類 一目で
• percentilew()、percentilesw() (集計関数)
• avg function