Apache IoTDB GROUP BY time()语法报错及正确用法咨询

问题场景 #

尝试使用GROUP BY time()对传感器温度数据按5分钟间隔做平均值聚合，但编写的SQL始终报错，需要修正语法以得到正确的聚合结果。

原始数据 #

创建时序数据并插入样本：

CREATE TIMESERIES `root.sg.d1.temperature` DOUBLE;
  
INSERT INTO `root.sg.d1`(`time`, temperature) VALUES ('2024-09-24T14:00:00.000+08:00', 25.0);
INSERT INTO `root.sg.d1`(`time`, temperature) VALUES ('2024-09-24T14:01:00.000+08:00', 26.0);
INSERT INTO `root.sg.d1`(`time`, temperature) VALUES ('2024-09-24T14:02:00.000+08:00', 27.0);
INSERT INTO `root.sg.d1`(`time`, temperature) VALUES ('2024-09-24T14:03:00.000+08:00', 28.0);
INSERT INTO `root.sg.d1`(`time`, temperature) VALUES ('2024-09-24T14:04:00.000+08:00', 29.0);
INSERT INTO `root.sg.d1`(`time`, temperature) VALUES ('2024-09-24T14:05:00.000+08:00', 30.0);

注：原始INSERT语句中的时间值未加单引号，实际执行时也会报错，这里一并修正。

报错情况分析 #

首次查询及报错 #

执行SQL：

SELECT avg(temperature)
FROM `root.sg.d1`
GROUP BY time(5m);

报错信息：

Error: 701: The query time range should be specified in the GROUP BY TIME clause.

原因：使用GROUP BY TIME时，必须明确指定查询的时间范围，否则数据库无法确定聚合区间的边界，因此触发701错误。

第二次查询及报错 #

添加起始时间后执行SQL：

SELECT avg(temperature)
FROM `root.sg.d1`
GROUP BY time(5m, 2024-09-24T14:00:00.000);

报错信息：

Error: 700: Error occurred while parsing SQL to physical plan

原因：

1. 时间参数未用单引号包裹，属于语法错误，导致SQL解析失败；
2. 部分版本的时序数据库要求GROUP BY time()中如果指定起始时间，必须同时指定结束时间，否则不符合语法规范。

正确SQL写法 #

写法一：在GROUP BY time()中指定完整时间范围 #

SELECT time, avg(temperature)
FROM `root.sg.d1`
GROUP BY time(5m, '2024-09-24T14:00:00.000+08:00', '2024-09-24T14:06:00.000+08:00');

写法二：用WHERE子句限定时间范围 #

SELECT time, avg(temperature)
FROM `root.sg.d1`
WHERE time >= '2024-09-24T14:00:00.000+08:00' AND time <= '2024-09-24T14:06:00.000+08:00'
GROUP BY time(5m);

注：查询字段中需包含time，才能在结果中显示每个聚合区间的时间戳。

期望结果 #

执行正确SQL后，将得到如下聚合结果：

内容的提问来源于stack exchange，提问作者Jiangang Bai