Конфигурирование Hibernate

5.1 Автоматическое создание схемы данных

При стартовом конфигурировании Hibernate можно включить очень много интересных настроек. Я не стал их приводить раньше, чтоб не распыляться. А вот в конце уровня думаю про некоторые из них все же рассказать.

Первая такая настройка — это параметр hbm2ddl.auto. У нее может быть 5 различных значений:

5.2 Логирование запросов

Вторая очень полезная настройка Hibernate — это логирование всех его запросов в базу: все запросы к базе дублируются в консоль. Это очень полезная функция, если ты вносишь изменения в код, связанный с Hibernate.

Во-первых, ты лучше поймешь, как твои запросы преобразуются в SQL. Во-вторых, легче и раньше сможешь находить ошибки. А они точно будут. Не всегда Hibernate работает так, как мы ожидаем. Особенно часто это связано с аннотациями: ты понимаешь из по-своему, а Hibernate — по-своему.

Настройка, включающая логирование, называется hibernate.show_sql. Если выставить ее значение в true, то в консоль будут писаться запросы к базе. Так же в паре с ним используется параметр hibernate.format_sql, который позволяет задать удобный формат SQL-запроса в логе.

Еще один способ логировать запросы к базе — это использовать стандартный логгер. Все дало в том, что Hibernate и так пишет свои запросы в стандартный логер, но только с областью видимости — DEBUG. Тебе нужно поменять два свойства в своем стандартном логере:

logging.level.org.hibernate.SQL=debug
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=trace

Изменение же уровня BasicBinder на trace добавит нам параметры запросы, правда, в слегка непривычной форме — поочередное перечислением после самого запроса.

Третий подход: использование специального proxy-драйвера к базе данных.

Например, log4jdbc или p6spy. Оба прокси рабочие и на них есть стартеры, хотя на log4jdbc давно не было коммитов на момент написания статьи.

<dependency>
    <groupId>com.integralblue</groupId>
    <artifactId>log4jdbc-spring-boot-starter</artifactId>
</dependency>
<dependency>
    <groupId>com.github.gavlyukovskiy</groupId>
    <artifactId>p6spy-spring-boot-starter</artifactId>
</dependency>

В детали вдаваться не буду, просто хочу, чтобы ты знал, что так можно.

5.3 Диалекты SQL

И еще немного справочной информации.

Hibernate поддерживает работу с очень большим количеством СУБД. Каждая их них реализует стандартный набор функций SQL и еще какие-то свои. Или разные версии SQL. Поэтому для работы с этими СУБД нужно сказать Hibernate, какой диалект языка SQL ему использовать.

Вот список наиболее популярных диалектов:

Конечно, таких диалектов может быть сколько угодно. Ты можешь написать свою СУБД и свой собственный диалект к ней.

Почему важно указывать правильный диалект?

У каждой базы данных типы данных могут немного отличаться. Поэтому чтобы Hibernate прямо идеально работал именно так, как ты от него ожидаешь, нужно указать ему, какой диалект SQL-языка ему нужно использовать.

Вот интересная картинка, которая показывает, как все связано на самом деле:

5.4 Популярные настройки

Чтобы упростить тебе жизнь, приведу полный список нескольких настроек:

hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
hibernate.connection.driver_class=com.mysql.cj.jdbc.Driver
hibernate.connection.url=jdbc:mysql://localhost:3306/test
hibernate.connection.username=root
hibernate.connection.password=secret
hibernate.show_sql=true
hibernate.hbm2ddl=validate

hibernate.dialect=org.hibernate.dialect.MySQL5Dialect
hibernate.connection.driver_class=com.mysql.jdbc.Driver
hibernate.connection.url=jdbc:mysql://localhost:3306/test
hibernate.connection.username=root
hibernate.connection.password=secret
hibernate.show_sql=true
hibernate.hbm2ddl=validate

hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
hibernate.connection.driver_class= org.postgresql.Driver
hibernate.connection.url= jdbc:postgresql://localhost/test
hibernate.connection.username=root
hibernate.connection.password=secret
hibernate.show_sql=true
hibernate.hbm2ddl=validate

MySQL 8.0 поддерживает больше возможностей, чем MySQL 5.0, так что если ты хочешь, чтобы Hibernate использовал их все по максимуму, то указывай правильный диалект.

База данных H2 обычно хранится в памяти, поэтому mem:test — это и имя SQL-сервера, и имя схемы, с которой ты будешь работать.