如何通过JPA的@Index注解创建基于子串的数据库索引？

标准的javax.persistence.Index注解不支持直接在columnList中写入函数表达式，因为JPA规范定义里，columnList仅接受实体属性对应的数据库列名，不允许包含如substring这类函数操作。

不过有两种可行的解决方式：

• 使用JPA提供商的扩展特性
  像Hibernate这类主流JPA实现，支持在@Index的columnList中直接写数据库函数表达式（只要目标数据库支持该函数）。示例代码如下：

  @Entity
  @Table(name = "annuaire", 
      indexes = {
              @Index(name = "annuaire_abc_substr_idx", columnList = "substring(abc,7,2)")
      }
  )
  public class Annuaire {
      // 实体属性定义...
  }
  

  注意：这属于特定提供商的非标准扩展，换用其他JPA实现（如EclipseLink）可能无法生效。

• 基于数据库生成列的规范方案
  如果你的数据库支持生成列（比如MySQL的GENERATED COLUMN、PostgreSQL的GENERATED AS），可以先在实体中映射一个由数据库自动计算的生成列，再对该列创建索引。这种方式完全符合JPA规范，兼容性更好：

  @Entity
  @Table(name = "annuaire", 
      indexes = {
              @Index(name = "annuaire_abc_substr_idx", columnList = "abc_substr")
      }
  )
  public class Annuaire {
      // 其他属性...
  
      @Column(name = "abc_substr", insertable = false, updatable = false,
              columnDefinition = "VARCHAR(2) GENERATED ALWAYS AS (substring(abc,7,2)) STORED")
      private String abcSubstr;
  }
  

  这里的abc_substr列由数据库自动根据abc列计算生成，我们只需要对这个普通列创建索引即可。

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