====== Hibernate Configurations ======
* hibernate properties, property
* [[https://github.com/hibernate/hibernate-orm/blob/main/hibernate-core/src/main/java/org/hibernate/cfg/AvailableSettings.java|org.hibernate.cfg.AvailableSettings]] 설정 상수 모음
* [[https://github.com/hibernate/hibernate-orm/blob/main/hibernate-core/src/main/java/org/hibernate/cfg/Environment.java|org.hibernate.cfg.Environemnt]] 설정 상수 모음
===== hibernate.hbm2ddl.auto 프라퍼티 =====
* http://gyumee.egloos.com/2483659 참조.
* [[https://docs.jboss.org/hibernate/orm/5.2/javadocs/org/hibernate/tool/schema/Action.html|schema Action]]
* ''create-only'' : 생성만하고, drop은 하지 않는다. 개발 모드에서 최초에 한 번 이걸로 실행하고, 다음에는 ''update''로 변경하면 될 듯. Hibernate 5.2 이상에서만 지원하는 것으로 보임.
* ''create'' : Session factory가 실행될 때에 스키마를 지우고 다시 생성. 클래스패스에 import.sql 이 존재하면 찾아서, 해당 SQL도 함께 실행함.
* ''create-drop'' : create와 같지만 session factory가 내려갈 때 스키마 삭제. 클래스패스에 import.sql 이 존재하면 찾아서, 해당 SQL도 함께 실행함.
* ''update'' : 시작시, 도메인과 스키마 비교하여 필요한 컬럼 추가 등의 작업 실행. 데이터는 삭제하지 않음.
* ''validate'' : Session factory 실행시 스키마가 적합한지 검사함. 문제가 있으면 예외 발생.
* 개발시에는 create가, 운영시에는 auto 설정을 빼거나 validate 정도로 두는 것이 좋아 보인다. update로 둘 경우에, 개발자들의 스키마가 마구 꼬여서 결국은 drop 해서 새로 만들어야 하는 사태가 발생한다.
===== hibernate.use_sql_comments 프라퍼티 =====
* Native SQL 쿼리로 변환할 때 쿼리에 대한 주석을 함께 달아준다.
===== hibernate.jdbc.time_zone =====
* [[http://in.relation.to/2016/09/12/jdbc-time-zone-configuration-property/|How to store timestamps in UTC using the new hibernate.jdbc.time_zone configuration property]]
* Hibernate 5.2.3 부터 Timestamp, Calendar 저장시 원하는 Timezone 으로 저장하도록 할 수 있다.
settings.put(
AvailableSettings.JDBC_TIME_ZONE,
TimeZone.getTimeZone( "UTC" )
);
// or
Session session = sessionFactory()
.withOptions()
.jdbcTimeZone( TimeZone.getTimeZone( "UTC" ) )
.openSession();
===== hibernate.temp.use_jdbc_metadata_defaults =====
* DB Sharding 처리를 Spring 차원에서 하고자할 때 ''hibernate.temp.use_jdbc_metadata_defaults=false''로 두어야 한다.
* [[http://stackoverflow.com/questions/10075081/hibernate-slow-to-acquire-postgres-connection|java - Hibernate Slow to Acquire Postgres Connection - Stack Overflow]]
* Hibernate 4 ''JdbcServicesImpl.java'' 주석.
// 'hibernate.temp.use_jdbc_metadata_defaults' is a temporary magic value.
// The need for it is intended to be alleviated with future development, thus it is
// not defined as an Environment constant...
//
// it is used to control whether we should consult the JDBC metadata to determine
// certain Settings default values; it is useful to *not* do this when the database
// may not be available (mainly in tools usage).
boolean useJdbcMetadata = ConfigurationHelper.getBoolean( "hibernate.temp.use_jdbc_metadata_defaults", configValues, true );
===== hibernate.enable_lazy_load_no_trans=true 금지 =====
* ''hibernate.enable_lazy_load_no_trans=true|false'' 사용하지 말 것. Open Session In View와 비슷한 역할.
* [[https://vladmihalcea.com/the-hibernate-enable_lazy_load_no_trans-anti-pattern/|The hibernate.enable_lazy_load_no_trans Anti-Pattern]]
===== hibernate.globally_quoted_identifiers=true =====
hibernate.globally_quoted_identifiers=true
hibernate.globally_quoted_identifiers_skip_column_definitions=true
* column, table 이름 등이 DB의 keyword 와 충돌할 때 대비하여 기본적으로 quote 시켜준다. DB별로 다른 quote 사용.
* 단, ''columnDefinition''에 있는 단어도 함께 escape 시켜버리는데, 이것을 방지하는게 ''hibernate.globally_quoted_identifiers_skip_column_definitions=true'' 프라퍼티이다.
* [[https://vladmihalcea.com/escape-sql-reserved-keywords-jpa-hibernate/|How to escape SQL reserved keywords with JPA and Hibernate - Vlad Mihalcea]]
===== hibernate.query.in_clause_parameter_padding =====
===== hibernate.query.plan_cache_max_size =====
* [[java:hibernate:performance|Hibernate Performance Tuning]] 참조
===== hibernate.query.fail_on_pagination_over_collection_fetch =====
* [[https://vladmihalcea.com/hibernate-query-fail-on-pagination-over-collection-fetch/|How to detect HHH000104 issues with hibernate.query.fail_on_pagination_over_collection_fetch - Vlad Mihalcea]]
* ''5.2.13'' 버전 이후 설정 가능.
* **To-Many** 관계를 join fetch 하게 되면 Many 측 관계로 인해서 정확한 갯수로 제약을 줄 수 없다. 이로 인해 하이버네이트는 모든 데이터를 다 가져온 뒤에 메모리에서 정렬하여 원하는 갯수만 획득하게 된다.
* 이는 심각한 메모리 문제, 성능 저하를 일으키게 된다.
* Hibernate 은 이 ''to-many'' 관계의 join fetch 에 대해 ''warning'' 로그를 남기지만 이것은 발견하기 매우 어렵다.
* ''hibernate.query.fail_on_pagination_over_collection_fetch=true'' 설정을 하면 아예 exception 을 발생시키게 된다.
* 항상 활성화하고 미리 에러를 잡는게 낫다.
hibernate.query.fail_on_pagination_over_collection_fetch=true