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

適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel

percentile()関数は、expr によって定義された母集団の指定されたnearest-rank パーセンタイルの推定値を計算します。 精度は、パーセンタイル リージョンの人口密度によって異なります。

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

加重百分位数を計算するには、 percentilesw()を参照してください。

構文

percentile(expr, percentile)

percentiles(expr, percentiles)

構文規則について詳しく知る。

パラメーター

返品

グループ内の指定されたパーセンタイルの expr の推定値を含むテーブルを返します。それぞれは個別の列にあります。

例

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

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

StormEvents | summarize percentile(DamageProperty, 95) by State

出力

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

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

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

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

出力

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

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

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

構文

percentiles_array(expr, percentiles)

パラメーター

返品

動的配列型の単一列として、グループ内の指定されたパーセンタイルの expr の推定値を返します。

例

コンマ区切りの百分位数

percentiles()と同様に、複数の列ではなく、1 つの動的列で複数のパーセンタイルを配列として取得できます。

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

出力

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

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

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

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

出力

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

最も近いランクのパーセンタイル

昇順で並べ替えられた順序付けされた値のリストの P 番目のパーセンタイル (0 <P<= 100) は、リスト内の最小の値です。 データの P パーセントが P 番目のパーセンタイル値以下です (パーセンタイルの Wikipedia 記事から)。

0 番目のパーセントを母集団の最小メンバーとして定義します。

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

パーセンタイル集計では、 T-Digestを使用して概算値を算出できます。

関連するコンテンツ

• avg 関数