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]