series_stats()

series_stats() 使用多个列返回数字序列的统计信息。

series_stats() 函数将一个返回动态数值数组的表达式作为输入,并计算以下统计信息:

统计信息 说明
min 输入数组中的最小值。
min_idx 输入数组中最小值的第一个位置。
max 输入数组中的最大值。
max_idx 输入数组中最大值的第一个位置。
avg 输入数组的平均值。
variance 输入数组的样本方差。
stdev 输入数组的样本标准偏差。

注意

此函数返回多个值,因此不能将其用作其他函数的输入。 如果只需要单个值(如“average”),请考虑使用 series_stats_dynamic

语法

...|extendseries_stats(Expr [,IgnoreNonFinite] )

...|extend(Name1 [,Name2...] )=series_stats(Expr [,IgnoreNonFinite] )

参数

  • Expr:一个返回 dynamic 类型值的表达式,该值包含一个数值数组。 数值是为其定义了算术运算符的值。

  • IgnoreNonFinite:一个布尔表达式,指定是否在计算统计信息时忽略 Expr 的非有限值(nullNaNinf 等)。 如果为 false,则 Expr 中具有此值的单个项会为所有统计值生成一个值,即 null。 默认值为 false

返回

语法 1

下面的语法导致添加以下新列(其中 Expr 是列引用 x):series_stats_x_minseries_stats_x_idx,依此类推。

...|extendseries_stats(Expr [,IgnoreNonFinite] )

语法 2

下面的语法生成名为 Name1Name2 之类的列,并按顺序包含这些值。

...|extend(Name1 [,Name2...] )=series_stats(Expr [,IgnoreNonFinite] )

示例

print x=dynamic([23,46,23,87,4,8,3,75,2,56,13,75,32,16,29]) 
| project series_stats(x)

series_stats_x_min series_stats_x_min_idx series_stats_x_max series_stats_x_max_idx series_stats_x_avg series_stats_x_stdev series_stats_x_variance
2 8 87 3 32.8 28.5036338535483 812.457142857143