无法使用SQL工具查询已创建的Apache Ignite缓存问题咨询

看起来你在通过Java客户端模式创建Ignite 2.2缓存后，遇到了SQL工具无法查询的问题，我来帮你梳理几个关键的排查点和解决方案：

1. 确认缓存是否启用SQL支持并配置查询实体 #

默认情况下，Ignite缓存不会自动开启SQL查询能力，你需要在CacheConfiguration中明确配置查询实体（QueryEntity），或者通过注解标记可查询字段：

方式一：使用注解（推荐） #

如果你的值对象是自定义类，在需要查询的字段上添加@QuerySqlField注解：

public class User {
    @QuerySqlField(index = true) // 标记为可查询字段，可选创建索引提升性能
    private Long userId;
    
    @QuerySqlField
    private String userName;
    
    // 构造器、getter/setter方法
}

然后在缓存配置中指定键值类型：

CacheConfiguration cacheConf = new CacheConfiguration("userCache")
    .setKeyType(Long.class) // 匹配你的实际键类型
    .setValueType(User.class);

方式二：手动配置QueryEntity #

如果无法修改实体类，可以通过QueryEntity手动配置可查询字段：

QueryEntity queryEntity = new QueryEntity()
    .setKeyType(Long.class.getName())
    .setValueType(User.class.getName())
    .addQueryField("userId", Long.class.getName(), null)
    .addQueryField("userName", String.class.getName(), null);

CacheConfiguration cacheConf = new CacheConfiguration("userCache")
    .setQueryEntities(Collections.singletonList(queryEntity));

2. 验证客户端是否成功加入集群 #

你的配置启用了客户端模式，但要确保客户端已正确连接到集群：

• 启动客户端时，检查日志是否有Successfully connected to cluster类的提示
• 可以通过代码验证集群连接状态：

Ignite ignite = Ignition.start(cfg);
System.out.println("当前集群节点数：" + ignite.cluster().nodes().size());

3. 检查SQL工具的连接配置是否正确 #

如果你用JDBC工具连接Ignite，注意JDBC连接端口和发现端口的区别：

• 你配置的48500..48520是集群发现端口，JDBC Thin客户端默认端口是10800
• 正确的JDBC URL示例：

jdbc:ignite:thin://127.0.0.1:10800

如果集群修改了Thin客户端端口，需要对应调整URL中的端口号。

4. 确认缓存存在且有数据写入 #

先通过代码验证缓存状态和数据：

Ignite ignite = Ignition.start(cfg);
Cache<Long, User> cache = ignite.cache("userCache");
System.out.println("缓存是否存在：" + ignite.cacheNames().contains("userCache"));
System.out.println("缓存数据量：" + cache.size());

如果缓存不存在，可能是创建时出错；如果数据量为0，SQL自然返回空结果。

5. 查看Ignite日志定位错误 #

检查集群节点和客户端的日志，有没有SQL query failed、Table not found这类错误提示。比如日志提示Table "USER" not found，说明查询实体没有正确配置，Ignite无法生成对应的SQL表。

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