使用Apache Ignite SQL API插入数据时提示表PERSONCACHE不存在

以下是几个常见的错误点及解决方法：

• QueryEntity表名配置不匹配或缺失
  Ignite的SQL引擎依赖QueryEntity来映射缓存到SQL表。如果你的QueryEntity没有显式设置tableName属性，或者设置的值和SQL语句中的表名不一致，就会触发找不到表的错误。
  正确的配置示例（XML）：

  <bean id="personQueryEntity" class="org.apache.ignite.cache.QueryEntity">
      <property name="keyType" value="java.lang.Long"/>
      <property name="valueType" value="com.yourcompany.Person"/>
      <property name="tableName" value="PERSONCACHE"/> <!-- 必须与SQL中的表名完全一致 -->
      <property name="fields">
          <map>
              <entry key="id" value="java.lang.Long"/>
              <entry key="name" value="java.lang.String"/>
          </map>
      </property>
      <property name="keyFields" value="id"/>
  </bean>
  

• QueryEntity未关联到缓存配置
  即使定义了QueryEntity，如果没有将它添加到对应缓存的queryEntities列表中，Ignite也无法识别对应的SQL表。检查服务端缓存配置：

  <bean class="org.apache.ignite.configuration.CacheConfiguration">
      <property name="name" value="personCache"/>
      <property name="queryEntities">
          <list>
              <ref bean="personQueryEntity"/> <!-- 确保引用了正确的QueryEntity -->
          </list>
      </property>
  </bean>
  

• SQL表名大小写不匹配
  Ignite的SQL默认对表名大小写敏感（可通过sqlSchemaCaseSensitivity配置修改），如果你的QueryEntity中tableName是PersonCache，但SQL语句中写了PERSONCACHE，就会导致表找不到。务必保证SQL中的表名和QueryEntity配置的tableName完全一致。

• 客户端未连接到正确的缓存/集群
  确认客户端连接的Ignite集群中确实存在personCache缓存，并且缓存已经正常启动。可以在客户端代码中先验证缓存是否存在：

  Ignite ignite = Ignition.start();
  IgniteCache<?, ?> cache = ignite.cache("personCache");
  if (cache == null) {
      // 缓存不存在，检查服务端配置或集群连接
  }
  

• 注解配置缺失（若使用注解替代XML）
  如果是用实体类注解（如@QuerySqlField）来配置SQL映射，需要确保实体类上添加了@CacheQueryEntity并指定正确的tableName，同时缓存配置启用了索引类型扫描：

  @CacheQueryEntity(tableName = "PERSONCACHE")
  public class Person {
      @QuerySqlField(index = true)
      private Long id;
      @QuerySqlField
      private String name;
      // 构造器、getter/setter
  }
  

  缓存配置中需添加：

  CacheConfiguration<Long, Person> cacheCfg = new CacheConfiguration<>("personCache");
  cacheCfg.setIndexedTypes(Long.class, Person.class);
  

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