percentile_tdigest()

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

tdigest の結果 (tdigest() または tdigest_merge() によって生成されたもの) から、パーセンタイルの結果を計算します

構文

percentile_tdigest( expr,percentile1,typeLiteral)

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

パラメーター

件名	タイプ	Required	説明
expr	string	✔️	tdigestまたは tdigest_merge()によって生成された式。
percentile	real	✔️	パーセンタイルを指定する値。
typeLiteral	string		型リテラル。 指定した場合、結果セットはこの型になります。 たとえば、 typeof(long) はすべての結果を long型にキャストします。

返品

expr 内の各値のパーセンタイル値。

ヒント

• 型が指定された場合、結果は、パーセンタイルの結果が入力された、同じ型の列になります。 この場合、すべての tdigest 関数は、その型である必要があります。
• exprに異なる型のtdigest関数が含まれている場合は、型を指定しないでください。 結果は dynamic 型になります。 次の例を参照してください。

例

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

この記事の例では、Weather Analytics サンプル データの StormEvents テーブルなど、一般公開されているテーブルを使用します。

状態による最大ダメージ

このクエリは、各状態の Storm イベントによって引き起こされる最大のプロパティ損害を見つけることを目的としています。

StormEvents
| summarize tdigestRes = tdigest(DamageProperty) by State
| project percentile_tdigest(tdigestRes, 100)

出力

percentile_tdigest_tdigestRes
0
62000000
110000000
1200000
250000

状態別の最大ダメージと最新の終了時刻

このクエリは、各状態の最大プロパティの損傷と、Storm イベントの最新の終了時刻を検索することを目的としています。

StormEvents
| summarize tdigestRes = tdigest(DamageProperty) by State
| union (StormEvents | summarize tdigestRes = tdigest(EndTime) by State)
| project percentile_tdigest(tdigestRes, 100)

出力

percentile_tdigest_tdigestRes
[0]
[62000000]
["2007-12-20T11:30:00.0000000Z"]
["2007-12-31T23:59:00.0000000Z"]