bin_auto()

将值向下舍入为固定大小的箱,并控制查询属性提供的箱大小和起点。

语法

bin_auto(value)

详细了解语法约定

参数

客户 类型​​ 必需 Description
value int、long、real、timespan 或 datetime 要舍入到箱中的值。

若要控制箱大小和起点,请在使用此函数之前设置以下参数。

名称 类型​​ 必需 说明
query_bin_auto_size int、long、real 或 timespan 指示每个箱的大小。
query_bin_auto_at int、long、real 或 timespan 指示 value 的一个值,它是一个“固定点”(即,bin_auto(fixed_point) == fixed_point 的 value)。 默认为 0。

返回

value 下 query_bin_auto_size 最接近的倍数已移位,因此 query_bin_auto_at 将被转换为自身。

示例

set query_bin_auto_size=1h;
set query_bin_auto_at=datetime(2017-01-01 00:05);
range Timestamp from datetime(2017-01-01 00:05) to datetime(2017-01-01 02:00) step 1m
| summarize count() by bin_auto(Timestamp)

输出

Timestamp count_
2017-01-01 00:05:00.0000000 60
2017-01-01 01:05:00.0000000 56