사용자 도구

사이트 도구


java:hibernate:configuration

Hibernate Configurations

hibernate.hbm2ddl.auto 프라퍼티

  • 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

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로 두어야 한다.
  • 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.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 프라퍼티이다.

hibernate.query.in_clause_parameter_padding

hibernate.query.plan_cache_max_size

hibernate.query.fail_on_pagination_over_collection_fetch

  • 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
java/hibernate/configuration.txt · 마지막으로 수정됨: 2023/07/03 14:53 저자 kwon37xi