Liquibase

Что это

Liquibase - утилита для версионирования структуры реляционной БД и миграции этой структуры с одной версии на другую.

Основные разделы

• All Liquibase types with related SQL & Java types
• Как она работает
• Команды
• Spring properties
• Советы
• Changelog
• Rollback
• databasechangelog table

Для работы через console необходимо установить Liquibase на устройство.

Команды

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

• url - url к БД.
• classpath - пусть на устройстве к драйверу к БД.
• username - к БД.
• password - к БД.
• changeLogFile - файл с необходимыми изменениями.

update - обновление базы с помощью changeLog файла.

liquibase
    --url=jdbc:postgresql://localhost:5434/app
    --classpath=/home/.../.m2/repository/org/postgresql/postgresql/42.5.0/postgresql-42.5.0.jar
    --username=name
    --password=pass
    --changeLogFile=db.changelog-2.0.xml
    update
        

Spring properties

spring.liquibase.change-log - параметр для указания root changelog файла. В котором будут указаны все необходимые changelog файлы в include блоках.

Пример

spring.liquibase.change-log=classpath:db/changelog/db.changelog-root.xml
        

Советы:

Лучше использовать xml формат для Idea подсвечивает ошибки.

Лучше создать master.xml file в котором будут все записи изменений.

Пример имен файлов изменений и его же использовать как id.

• 01_create_user_table.xml
• 02_alter_user_table.xml
• 03_create_user_table_v2.xml

Changelog

Changelogs - file для описания изменений.

databaseChangeLog

databaseChangeLog - главный блок в котором описываются изменения.

changeSet

changeSet - блок в котором описываются изменения.

preConditions

preConditions - блок для описания условий для выполнения изменений.

rollback

rollback - тег для добавления SQL команды, которые будут выполнены во время выполнения rollback команды.

Варианты rollback

• rollbackCount - по количеству необходимых откатов от последнего.
• rollback - по установленному tag метке.
• rollbackDate - по дате изменения до которого необходимого откатить.

Databasechangelog table

databasechangelog - таблица для хранения метаданных Liquibase.

Поля

1. id - id изменения.
2. author
3. filename - путь к changelog файлу.
4. dateexecuted
5. orderexecuted
6. exectype
7. md5sum - хэшсумма файла.
8. description
9. comments
10. tag
11. liquibase
12. contexts
13. labels
14. deployment_id