TDengine 中 Interval 的自动窗口偏移优化实践

1. 从手动算偏移到自动对齐：为什么我们需要 auto offset？

如果你用过 TDengine 的 INTERVAL 查询，大概率遇到过这样一个有点烦人的问题：我想按每5分钟一个窗口，统计今天早上9点之后的数据。写出来的 SQL 大概是 SELECT ... WHERE ts >= '2024-01-01 09:00:00' INTERVAL(5m)。结果一看，第一个窗口怎么是从 00:00:00 开始的？数据被切得七零八落，完全不是我想要的那个“从9点整开始”的5分钟窗口。

这就是 INTERVAL 查询的默认行为：时间窗口的划分，默认是从时间戳的“纪元原点”（比如 1970-01-01 00:00:00）开始的。你的 WHERE 条件只是过滤数据，不影响窗口的起始点。为了让窗口从你的查询起始时间开始，你就得手动计算一个偏移量 interval_offset。比如，从 09:00:00 开始，那偏移量就是 9h。你得先看看表里最早的数据是几点，再算算和整点差多少，有时候还得考虑时区，挺折腾的。

我刚开始用的时候，没少在这上面踩坑。有一次做按小时聚合的日报，我直接用了 INTERVAL(1h)，结果每天的报告时间窗口都是 00:00, 01:00... 但业务方习惯看的是 08:00 到次日 08:00 作为一个自然日。为了对齐这个时间，我不得不在应用层写了一大段逻辑，先查询再后处理，代码又臭又长，性能还差。

所以，当 TDengine 在后续版本中引入了 INTERVAL(interval_val, interval_offset) 语法，支持指定偏移量时，确实解决了一部分问题。但痛点依然存在：每次写查询，我都得当个“人肉计算器”。业务时间点一变，我就得重新算。更麻烦的是，如果查询条件是动态的，比如前端用户选择了一个时间范围，这个偏移量在代码里就几乎没法动态生成了，除非写复杂的字符串拼接。

正是这些实际开发中的不便，催生了 auto offset 这个特性。它的设计目标非常直接：让你在 WHERE 子句里指定从什么时候开始查，INTERVAL 的窗口就从什么时候开始划。你不再需要关心 offset 到底该写 8h 还是 -1d3h，直接把 offset 参数写成 auto，数据库引擎自己会去解析你的时间过滤条件，并自动计算出正确的窗口起始点。这就像给你的 SQL 查询装上了“自动对齐”功能，省心省力，也大大减少了出错的概率。

2. 实战入门：5分钟上手 auto offset 基础用法

光说概念可能有点虚，我们直接动手，建个表，插点数据，看看 auto 到底是怎么工作的。我会用一个监控电表数据的经典场景来演示，这个场景里，时间窗口的分析非常普遍。

首先，我们创建一个超级表（STable）和子表（Table），模拟一下电表数据：

-- 创建超级表，定义电表的 schema
CREATE STABLE meters (ts TIMESTAMP, voltage INT, current FLOAT) TAGS (location BINARY(50), meter_id INT);

-- 基于超级表创建具体的电表 d1001
CREATE TABLE d1001 USING meters (location, meter_id) TAGS ('Beijing.Floor1', 1001);

接着，我们插入一些测试数据。为了让效果更明显，我特意让数据的时间戳不是从整秒开始的：

-- 向电表 d1001 插入几条电压读数
INSERT INTO d1001 VALUES
  ('2024-01-01 08:00:01.500', 220, 1.5),
  ('2024-01-01 08:00:02.800', 219, 1.6),
  ('2024-01-01 08:00:04.200', 221, 1.55),
  ('2024-01-01 08:00:07.000', 218, 1.7),
  ('2024-01-01 08:00:09.300', 222, 1.4);