Какие значения может принимать Hibernate hbm2ddl.auto и что они делают?

Полный разбор параметра hibernate.hbm2ddl.auto

Этот параметр управляет тем, как Hibernate взаимодействует со схемой базы данных при запуске приложения. Всего существует 5 основных значений. Давайте разберем каждое на конкретных примерах.

1. none (значение по умолчанию)

Hibernate вообще не трогает схему БД. Таблицы должны быть созданы вручную (через SQL-скрипты или миграции). Самый безопасный вариант для продакшна.

<property name="hibernate.hbm2ddl.auto">none</property>

2. create

При каждом запуске приложения Hibernate удаляет все таблицы, соответствующие сущностям, и создает их заново. Все данные безвозвратно теряются.

// Пример: при старте Hibernate выполнит:
DROP TABLE IF EXISTS users;
CREATE TABLE users (id BIGINT, name VARCHAR(255), email VARCHAR(255));

Использовать только в разработке для тестирования маппингов.

3. create-drop

Как create, но таблицы удаляются при остановке SessionFactory (когда приложение завершается). Идеально для unit-тестов или in-memory баз (H2).

// В конце работы приложения:
DROP TABLE IF EXISTS users;

4. update

Самый коварный режим. Hibernate сравнивает текущую схему БД с маппингами сущностей и добавляет новые таблицы/колонки, но никогда не удаляет существующие. Пример:

// Было: User с полями id, name, email
// Добавили поле phone:
ALTER TABLE users ADD COLUMN phone VARCHAR(255);
// Удалили поле email — ничего не произойдет, колонка останется

Никогда не используйте в продакшне! Может привести к неожиданному блокированию таблиц на больших объемах данных.

5. validate

Hibernate только проверяет, что схема БД соответствует маппингам. Если несоответствие найдено (например, нет колонки email), выбрасывается исключение SchemaValidationException. База данных не изменяется.

// Если таблица users не имеет колонки email, при старте:
org.hibernate.tool.schema.spi.SchemaManagementException: Schema-validation: missing column [email] in table [users]

Рекомендуется для продакшна в паре с миграциями (Liquibase/Flyway).

Рекомендации по использованию

• Локальная разработка: create-drop или update (если жалко тестовых данных)
• Тесты: create-drop (автоматическая очистка)
• Продакшн: validate + инструменты миграции (Flyway/Liquibase)
• Никогда: create или update в продакшне — это путь к потере данных

В современных проектах Hibernate используют так:

// application.properties (Spring Boot)
spring.jpa.hibernate.ddl-auto=validate
spring.flyway.enabled=true  // или spring.liquibase.enabled=true

Так вы получаете контролируемые миграции через SQL-скрипты, а Hibernate только проверяет, что код соответствует базе.