WIDTH_BUCKET

WIDTH_BUCKET 可以用于构造分隔为相等间隔的直方图区间。此函数返回表达式值落入的桶的编号。

根据需要,WIDTH_BUCKET 可以创建编号为 0 的下溢桶和编号为 num_buckets+1 的溢出桶。这些桶处理指定区间之外的值,并有助于检查末端点是否合理。

返回值

NUMBER

语法

WIDTH_BUCKET
   (expr, min_value, max_value, num_buckets)

参数

expr 是为之创建直方图的表达式。此表达式的求值结果必须为数字或日期时间值或数值。如果 expr 求值结果为空,那么此函数返回空值。

min_valuemax_valueexpr 可接受区间端点的表达式。这两个表达式的求值结果必须为数字或日期时间值,两者都不能为空值。

num_buckets 是桶编号的表达式。此表达式的值必须为正整数。

示例

WIDTH_BUCKET(13, 0, 20, 4) 返回值 3。它从 0 到 20 创建了 4 个桶,将值 13 分入桶 3。

WIDTH_BUCKET(-5, 0, 20, 4) 返回值 0。值 -5 低于区间下限。