如何让Hibernate将连续INSERT语句合并为多值INSERT

我有如下JPA实体：

@Entity
@Table(name = "timeseries_data")
public class TimeseriesDataEntry implements Serializable {
    @Id
    @Column(name = "timeseries_id", nullable = false)
    private String timeseriesID;

    @Id
    @Column(name = "data_timestamp", nullable = false)
    private Instant timestamp;

    @Column(name = "data_value")
    private BigDecimal value;

    // constructor/setter/getter boilerplate etc.
}

需要实例化大量该实体并高效持久化，当前实现代码如下：

List<TimeseriesDataEntry> entries = new ArrayList<>();
Instant timestamp = Instant.EPOCH;
for (int i = 1; i <= 100; i++) {
    entries.add(new TimeseriesDataEntry("some-ts-id", timestamp, BigDecimal.valueOf(i)));
    timestamp = timestamp.plusHours(1);
}
entries.forEach(entityManager::persist);
entityManager.flush();

开启hibernate.show_sql=true后，Hibernate输出100条独立INSERT语句，PostgreSQL日志也显示这些语句被单独执行。虽然在JDBC连接串启用reWriteBatchedInserts=true后，数据库会合并为多值INSERT，但Hibernate仍会日志独立语句。

我希望直接通过Hibernate实现多值INSERT转换，不依赖数据库特定JDBC设置。已设置hibernate.jdbc.batch_size=100，且PostgreSQLDialect支持supportsValuesListForInsert和supportsValuesList，但功能未生效，请问该如何配置？

要让Hibernate直接生成多值INSERT语句，需要补充以下配置和代码调整：

• 添加关键Hibernate配置
  在你的persistence.xml或application.properties/yaml中加入：

  # 确保同表INSERT语句被排序，便于批量处理
  hibernate.order_inserts=true
  # 由于实体没有乐观锁版本字段，需关闭版本数据的批量处理
  hibernate.jdbc.batch_versioned_data=false
  

  已设置的hibernate.jdbc.batch_size=100保留，这个参数控制批量插入的批次大小。

• 调整持久化代码逻辑
  不要用forEach直接调用persist，改为循环处理并适时flush/clear，避免内存占用过高，同时确保Hibernate能正确批量处理：

  List<TimeseriesDataEntry> entries = new ArrayList<>();
  Instant timestamp = Instant.EPOCH;
  int batchSize = 100;
  for (int i = 1; i <= 100; i++) {
      entityManager.persist(new TimeseriesDataEntry("some-ts-id", timestamp, BigDecimal.valueOf(i)));
      timestamp = timestamp.plusHours(1);
      
      // 每达到批次大小就执行flush和clear
      if (i % batchSize == 0) {
          entityManager.flush();
          entityManager.clear();
      }
  }
  // 处理剩余不足一个批次的数据
  entityManager.flush();
  entityManager.clear();
  

• 确认Hibernate版本和方言
  确保使用的Hibernate版本在5.2及以上（多值INSERT功能从该版本开始支持），同时方言配置为正确的PostgreSQL方言，比如org.hibernate.dialect.PostgreSQLDialect或对应版本的方言（如PostgreSQL10Dialect）。

• 验证效果
  开启hibernate.format_sql=true，此时Hibernate日志会显示类似INSERT INTO timeseries_data (data_value, timeseries_id, data_timestamp) VALUES (?, ?, ?), (?, ?, ?), ...的多值插入语句，PostgreSQL日志也会显示合并后的单条INSERT。

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