共用方式為


percentile_array_tdigest()

計算結果 tdigest 的百分位數結果(由 tdigest()tdigest_merge()產生)

語法

percentiles_array_tdigest(tdigest, percentile1 [, percentile2, ...])

percentiles_array_tdigest(tdigest, Dynamic array [, typeLiteral ])

深入瞭解 語法慣例

參數

姓名 類型​​ 必要 描述
tdigest string ✔️ tdigest用來計算百分位數的 或 tdigest_merge() 結果。
百分比 real ✔️ 值或以逗號分隔的值清單,指定百分位數。
動態陣列 dynamic ✔️ 指定百分位數之實數的動態數位。
typeLiteral string 類型常值。 例如: typeof(long) 。 如果提供,則結果集為此類型。

傳回

tdigest每個值的百分位數/百分位數值。

提示

  • 函式必須至少接收一個百分比(而且可能更多,請參閱上述語法: percentile1 [, percentile2] ...[, percentileN]] 和結果將會是包含結果的動態陣列。 (如 percentiles()
  • 如果只提供一個百分比,而且也提供類型,則結果會是與該百分比結果一起提供之相同類型的數據行。 在此情況下,所有 tdigest 函式都必須是該類型。
  • 如果 tdigest 包含 tdigest 不同類型的函式,請勿提供類型。 結果的類型為動態。 請參閱下列範例。

範例

StormEvents
| summarize tdigestRes = tdigest(DamageProperty) by State
| project percentiles_array_tdigest(tdigestRes, range(0, 100, 50), typeof(int))

輸出

percentile_tdigest_tdigestRes
[0,0,0]
[0,0,62000000]
[0,0,110000000]
[0,0,1200000]
[0,0,250000]