IoTDB 查询

从实际使用场景出发，介绍夜莺 IoTDB 数据源告警：用 IoTDB SQL 查询设备数据做告警判定，时间条件自动补全的机制，以及值字段、标签字段、时间字段的配置。

概述

Apache IoTDB 是面向物联网、工业设备场景的时序数据库。接成告警数据源后，用 IoTDB SQL 查询设备数据并判定告警。

和其它 SQL 类数据源相比，IoTDB 有两个特点：查询走 表模型（Table Model） 的 SQL；时间范围不用自己写，引擎会按「时间间隔」自动给 SQL 补上时间条件。

字段	必填	说明
数据源类型 / 数据源	是	选 `IoTDB` 类型并选中已接入的实例
查询条件	是	IoTDB SQL 语句，如 `select time, temperature, device from db1.d1`
时间间隔	是	查询回看的时间区间，单位可选秒 / 分钟 / 小时，默认 1 分钟
元信息	否	点右侧「元信息」按数据库 → 表 → 字段浏览；点数值型字段会自动生成 SQL 并回填值字段、时间字段
值字段（辅助配置）	建议填	查询结果里哪些列作为指标（metricName），指标值就是该列的数值
标签字段（辅助配置）	否	哪些列作为告警事件的标签，通常是设备号、产线、机房这类维度列
时间字段（辅助配置）	否	哪一列是时间列，默认 `time`
告警条件	是	基于查询结果写告警表达式，如 `$A > 30`
执行频率	是	多久跑一次查询

下面按实际使用场景介绍。

「某条产线上的设备温度超过 30 度就告警」，查询写：

select time, temperature, device from db1.d1

辅助配置里：

告警条件写 $A > 30。写完点「数据预览」看一眼曲线，确认查询结果和字段映射符合预期，再配阈值。

告警查询不会带上单独的「数据库」选项，SQL 里建议写成 数据库名.表名 的完整形式，避免解析不到表。

IoTDB 的查询默认不用带时间条件——引擎会按「时间间隔」推出 [当前时间 - 间隔, 当前时间] 的窗口，自动往 SQL 里补一个时间条件。比如时间间隔选 1 分钟，实际执行的是：

select time, temperature, device from db1.d1 WHERE time >= 1784300000000 AND time <= 1784300060000

（IoTDB 的时间是毫秒时间戳，补出来的条件也是毫秒。）

几个细节：

SQL 里已经写了时间列的比较条件（>=、<=、between、in 等）时，不再自动补，以你写的为准；
自动补的条件会插在 GROUP BY / HAVING / ORDER BY / LIMIT 这些子句之前；SQL 里已经有 WHERE 就用 AND 拼接；
时间列不叫 time 时，要在辅助配置的「时间字段」里改成实际列名，否则补出来的条件会指向不存在的列。