如何使用GridDB Java API为多列创建复合索引并验证其查询生效情况

嘿，我来帮你搞定GridDB复合索引的问题，刚好对这块熟得很！针对你的两个问题，我给你一步步讲清楚：

1. 用Java API创建timestamp和sensor_id的复合索引 #

其实GridDB的Java API是支持复合索引的，只是你之前用的是单列索引的写法。createIndex方法可以接受多个列名参数，直接定义复合索引。这里要特别注意复合索引的列顺序：建议把用=匹配的sensor_id放在前面，再放做范围查询的timestamp——因为等值匹配能快速缩小数据集范围，再做时间过滤会让索引效率最大化。

修改后的代码示例如下：

ColumnInfoList columnInfo = new ColumnInfoList();
columnInfo.add(new ColumnInfo("timestamp", GSType.TIMESTAMP));
columnInfo.add(new ColumnInfo("sensor_id", GSType.STRING));
TimeSeriesContainer container = gridStore.putTimeSeries("sensor_data", columnInfo, true);

// 创建复合索引：先放sensor_id，再放timestamp，索引名可以自定义
container.createIndex("sensor_ts_composite_idx", IndexType.TREE, "sensor_id", "timestamp");

把原来的两个单列索引替换成这一个复合索引就行，IndexType.TREE非常适合你这种“等值+范围”的查询场景。

2. 验证复合索引是否被查询使用 #

有三种实用方法可以确认索引在工作：

方法一：用EXPLAIN语句查看执行计划 #

GridDB支持EXPLAIN关键字，能输出查询的执行计划，里面会明确显示是否用到了目标索引。你可以用Java API执行这个语句，然后查看结果：

// 准备查询参数（替换成你实际的参数值）
List<Object> params = Arrays.asList(Timestamp.valueOf("2024-01-01 00:00:00"), "sensor_001");
// 执行带EXPLAIN的查询
Query query = gridStore.query("EXPLAIN SELECT * FROM sensor_data WHERE timestamp > ? AND sensor_id = ?", params);
RowSet rowSet = query.fetch();

// 打印执行计划内容
while (rowSet.hasNext()) {
    Row row = rowSet.next();
    System.out.println(row.getString("PLAN"));
}

如果执行计划里出现你的复合索引名sensor_ts_composite_idx，并且标注了INDEX SCAN（而不是全表扫描的FULL SCAN），就说明索引已经生效了。

方法二：查看GridDB的查询日志 #

你可以调整GridDB的配置文件（gs_cluster.json），把logLevel改成DEBUG或者TRACE，然后重启集群。之后在GridDB的日志文件里搜索你的查询语句，会看到类似“Using index: sensor_ts_composite_idx”的日志条目，这也能证明索引在被使用。

方法三：对比索引创建前后的查询耗时 #

在创建复合索引前后，分别执行相同的查询多次，取平均耗时。如果创建索引后耗时明显下降（比如从几秒降到几十毫秒，具体看你的数据量），那也能间接证明索引在工作——毕竟全表扫描和索引扫描的性能差距是非常大的。

备注：内容来源于stack exchange，提问作者Ammar