GreptimeDB 索引语法统一方案设计与实现

在时序数据库 GreptimeDB 的最新演进中，开发团队针对索引创建语法进行了重要的标准化设计。本文将深入解析这一改进的技术背景、设计方案及其对用户使用体验的提升。

背景与现状分析

当前 GreptimeDB 支持三种主要索引类型，但存在语法不统一的问题：

1. 倒排索引(INVERTED INDEX)需要通过表约束语法显式创建
2. 跳跃索引(SKIPPING INDEX)和全文索引(FULLTEXT)仅支持列约束语法

这种不一致性给用户带来了认知负担和使用门槛。随着数据库功能的不断丰富，统一索引创建语法成为提升产品易用性的关键改进点。

标准化设计方案

经过核心开发团队的深入讨论，最终确定了双轨制的语法标准化方案：

列约束语法

<列名> <类型> [其他约束] [索引类型 INDEX [WITH (选项键="值")]]

典型示例：

`level` STRING PRIMARY KEY SKIPPING INDEX WITH (option = 'a')

表约束语法

<索引类型> INDEX (<列列表>) [WITH (选项键="值")]

典型示例：

CREATE TABLE logs (
    message STRING,
    `level` STRING PRIMARY KEY,
    `timestamp` TIMESTAMP TIME INDEX,
    FULLTEXT INDEX (`message`) WITH (option = 'a')
);

关键技术决策

1. 强制INDEX关键字：所有索引创建必须显式包含INDEX关键字，如使用FULLTEXT INDEX而非简单的FULLTEXT，提高语法明确性。

2. 取消默认索引创建：移除自动为所有标签列创建倒排索引的逻辑，改为完全由用户显式控制，这虽然带来一定的迁移成本，但显著提高了系统的可预测性。

3. 选项参数支持：两种语法都支持WITH子句传递索引配置参数，为未来扩展预留空间。

实现考量与最佳实践

对于复合索引的支持，表约束语法显然是更自然的选择。开发团队建议：

• 单列索引优先使用列约束语法，简洁明了
• 复合索引必须使用表约束语法
• 需要配置参数的索引建议使用表约束语法，提高可读性

版本兼容与迁移

该变更属于破坏性更新，用户需要注意：

1. 现有自动创建的倒排索引需要显式声明
2. 简单的FULLTEXT/SKIPPING语法需要添加INDEX关键字
3. 建议在升级前检查所有索引创建语句

这一改进使GreptimeDB的索引系统更加一致和可预测，为后续支持更丰富的索引类型和功能奠定了坚实的基础。