GreptimeDB 中 Interval 类型在范围查询中的使用问题分析

在时序数据库 GreptimeDB 0.13.0 版本中，用户在使用范围查询(Range Query)时发现了一个与 Interval 数据类型相关的兼容性问题。当用户尝试在 RANGE 子句中使用 Interval 类型表达式时，系统会抛出 DataFusion 规划错误，而直接使用 PromQL 风格的时间字符串则能正常工作。

问题现象

用户在执行如下 SQL 查询时遇到了错误：

SELECT ts, avg(val) RANGE ('15 minutes'::INTERVAL) FILL LINEAR 
FROM `vector_component_received_events_total` 
WHERE `component_id` = 'src-5' 
ALIGN '15m' 
ORDER BY ts ASC 
LIMIT 5;

系统返回的错误信息表明 DataFusion 在查询规划阶段无法处理这个 Interval 类型的参数：

ERROR 1815 (HY000): (PlanQuery): DataFusion error: Error during planning: Illegal argument `Utf8("15 minutes")` in range select query

技术背景

GreptimeDB 支持两种形式的时间范围指定方式：

1. PromQL 风格的时间字符串：如 "15m"、"1h30m" 等，这是 Prometheus 查询语言中常用的时间表示方法

   • ms - 毫秒
   • s - 秒
   • m - 分钟
   • h - 小时
   • d - 天
   • w - 周
   • y - 年

2. SQL Interval 类型：标准的 SQL 时间间隔表示法，如 "15 minutes"、"1 hour 30 minutes" 等

根据 GreptimeDB 官方文档，这两种形式都应该被支持，但在实际使用中发现 Interval 类型的支持存在问题。

问题根源

经过分析，这个问题是由于 DataFusion 查询引擎在规划阶段对 Interval 类型参数的处理逻辑发生了变化，导致原本支持的 Interval 类型表达式现在被识别为非法参数。

临时解决方案

在当前版本中，用户可以先使用 PromQL 风格的时间字符串作为替代方案：

SELECT ts, avg(val) RANGE '15m' FILL LINEAR 
FROM `vector_component_received_events_total` 
WHERE `component_id` = 'src-5' 
ALIGN '15m' 
ORDER BY ts ASC 
LIMIT 5;

这种写法能够正常工作并返回预期的查询结果。

长期解决方案

开发团队已经确认这是一个需要修复的问题，并计划在后续版本中恢复对 Interval 类型的完整支持。修复工作将涉及：

1. 更新 DataFusion 相关的查询规划逻辑
2. 确保 Interval 类型表达式能够被正确解析和处理
3. 添加相应的测试用例防止回归

最佳实践建议

对于当前使用 GreptimeDB 0.13.0 版本的用户，建议：

1. 优先使用 PromQL 风格的时间字符串进行范围查询
2. 如果必须使用 Interval 类型，可以考虑在应用层进行转换
3. 关注后续版本更新，及时升级以获得完整的 Interval 类型支持

这个问题虽然不影响基本功能的使用，但对于需要与标准 SQL 兼容的应用场景可能会造成一定的不便。开发团队已经将修复工作提上日程，预计在下一个版本中解决这个问题。