# JPA batch 쓰기 설정 `HibernateJpaBatchExecutor`는 고급 opt-in이다. 템플릿은 Hibernate batch 쓰기 설정을 전역으로 켜지 않는다. 통계와 문장 재정렬은 bulk 쓰기를 한 번도 하지 않는 애플리케이션에도 런타임 비용을 더하기 때문이다. ## executor가 가지는 것 `JpaBatchProfile`이 batch 실행 한 번의 JDBC batch 크기를 가진다. executor는 첫 항목을 쓰기 전에 `profile.jdbcBatchSize()`를 지금 Hibernate `Session`에 적용한다. 앞 Session 값은 실패한 실행을 포함해 `finally`에서 되돌린다. executor는 트랜잭션을 열지 **않는다**. 애플리케이션 서비스가 먼저 `TransactionPort.inWrite(...)` 경계에 들어가야 한다. ## 애플리케이션이 설정할 것 profile이 insert나 update 정렬을 요구하면, 맞는 Hibernate 설정이 SessionFactory에 이미 켜져 있어야 한다. ```yaml spring: jpa: properties: hibernate: order_inserts: true order_updates: true generate_statistics: true ``` `BatchExecutionResult`가 잰 flush와 prepared statement의 차이를 보고하므로 `hibernate.generate_statistics=true`가 필요하다. 통계 registry가 꺼져 있으면 그 값이 그럴듯한 0이 된다. `HibernateStatisticsCollector`는 계측된 `JdbcBatchCounter`도 받아야 한다. 이 executor에는 `HibernateStatisticsCollector.of(sessionFactory)`가 일부러 모자라다. Hibernate 통계는 실제 JDBC batch 실행을 드러내지 않는다. `hibernate.default_batch_fetch_size`는 이 쓰기 executor와 상관없다. 연관 fetch에 영향을 주고, 쿼리·fetch 조정에 속한다. ## 엔티티 식별자 제약 `JpaBatchProfile.batchingRequired()`가 참이면 `GenerationType.IDENTITY`를 쓰는 엔티티는 `HibernateBatchConfigurationGuard`가 거부한다. Hibernate는 생성된 식별자를 얻으려고 INSERT마다 바로 실행해야 하므로, JDBC insert batching으로는 그 profile을 채울 수 없다. insert batching이 필요한 작업에는 sequence 기반 식별자를 쓴다. sequence의 allocation size는 DB 마이그레이션과 맞춰 둔다. ## 실패 동작 설정은 persister가 첫 항목을 받기 전에 확인한다. - profile이 insert 정렬을 요구하는데 `hibernate.order_inserts=true`가 없다: 실패. - profile이 update 정렬을 요구하는데 `hibernate.order_updates=true`가 없다: 실패. - Hibernate 통계가 꺼져 있다: 실패. - JDBC batch 계측이 없다: 실패. - 호출자가 가진 트랜잭션이 없다: 실패. 이 실패는 일부러다. 행마다 문장 하나로 조용히 떨어지는 batch API는 데이터는 맞지만 성능 증거는 거짓이고, 그것은 기동이나 호출 실패보다 알아채기 어렵다.