如何通过ArangoDB Java驱动创建并检索调试用查询？

嘿，我完全懂你的需求——你想通过Java API像创建集合、图那样，程序化地创建、保存调试用的AQL查询，而不是只能在查询运行时拿到QueryEntity。其实ArangoDB的Java驱动早就支持这个功能啦，下面给你一步步拆解实现方法：

1. 保存命名查询 #

ArangoDB允许你将常用的AQL查询保存为命名查询（持久化存储，重启数据库后不会丢失），Java驱动通过ArangoQuery接口的saveQuery()方法实现这个功能。

代码示例： #

// 初始化ArangoDB客户端连接
ArangoDB arangoDB = new ArangoDB.Builder()
        .host("localhost", 8529)
        .user("root")
        .password("your-db-password")
        .build();

// 定义要保存的查询名称和AQL语句
String queryName = "debug-active-users";
String debugAql = "FOR u IN users FILTER u.isActive == true RETURN {id: u._key, name: u.name}";

// 保存查询（可选设置是否为系统查询，默认false）
SaveQueryOptions options = new SaveQueryOptions().isSystem(false);
QueryEntity savedQuery = arangoDB.query().saveQuery(queryName, debugAql, options);

// 打印保存后的查询元数据
System.out.println("已保存查询ID: " + savedQuery.getId());
System.out.println("查询名称: " + savedQuery.getName());

2. 检索已保存的查询 #

你可以通过查询名称或ID获取已保存的查询，也可以列出所有命名查询：

代码示例： #

// 根据名称检索指定查询
QueryEntity retrievedQuery = arangoDB.query().getQuery(queryName);
System.out.println("检索到的AQL语句: " + retrievedQuery.getQuery());

// 列出所有已保存的命名查询
Collection<QueryEntity> allSavedQueries = arangoDB.query().getAllQueries();
for (QueryEntity query : allSavedQueries) {
    System.out.printf("查询[%s]: %s%n", query.getName(), query.getQuery());
}

3. 更新或删除命名查询 #

如果需要调整调试查询，或者清理不再需要的查询，可以用以下方法：

代码示例： #

// 更新已保存的查询语句
String updatedAql = "FOR u IN users FILTER u.isActive == true AND u.age >= 18 RETURN {id: u._key, name: u.name, age: u.age}";
arangoDB.query().updateQuery(queryName, updatedAql, new UpdateQueryOptions());

// 删除指定命名查询
arangoDB.query().deleteQuery(queryName);

注意事项 #

• 命名查询是全局级别的（不属于某个特定数据库），所以查询名称在整个ArangoDB实例中必须唯一
• 操作命名查询需要拥有admin或write级别的权限
• 保存的命名查询是持久化的，和临时的查询缓存不同，重启数据库后依然存在

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