histogram()

Timescale Cloud：性能、扩展性、企业级

自托管产品

MST

histogram() 函数将一组值的分布表示为等宽桶的数组。它将数据集划分为指定数量的桶（nbuckets），范围介于输入的 min 和 max 值之间。

返回值是一个包含 nbuckets+2 个桶的数组，其中中间的 nbuckets 个桶用于指定范围内的值，数组开头的第一个桶用于低于下限 min 的值，最后一个桶用于大于或等于上限 max 的值。每个桶都包含其下限，但不包含其上限。因此，等于 min 的值包含在以 min 开头的桶中，但等于 max 的值则在最后一个桶中。

必需参数

名称	类型	描述
`value`	任意值	一组要划分成直方图的值
`min`	数值型	直方图分桶时使用的下限（包含）
`max`	数值型	直方图分桶时使用的上限（不包含）
`nbuckets`	整型	直方图桶（分区）数量的整数值

示例用法

从 readings 数据集对设备电池电量进行简单分桶


SELECT device_id, histogram(battery_level, 20, 60, 5)
FROM readings
GROUP BY device_id
LIMIT 10;

预期输出


device_id  |          histogram
------------+------------------------------
 demo000000 | {0,0,0,7,215,206,572}
 demo000001 | {0,12,173,112,99,145,459}
 demo000002 | {0,0,187,167,68,229,349}
 demo000003 | {197,209,127,221,106,112,28}
 demo000004 | {0,0,0,0,0,39,961}
 demo000005 | {12,225,171,122,233,80,157}
 demo000006 | {0,78,176,170,8,40,528}
 demo000007 | {0,0,0,126,239,245,390}
 demo000008 | {0,0,311,345,116,228,0}
 demo000009 | {295,92,105,50,8,8,442}

histogram()

必需参数

示例用法

相关内容