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() 结果。 |
percentile | 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] |