Данный гайд посвящен использованию Liquibase в Spring Boot приложениях с помощью Amplicode для наиболее удобного и эффективного управления базами данных.

Для прохождения этого гайда можно перейти в репозиторий с гайдами (https://github.com/Amplicode/amplicode-tutorials) и выполнить шаги, описанные в инструкции по адресуhttps://github.com/Amplicode/amplicode-tutorials/blob/main/liquibase-and-spring-boot/README.md.

1. Подключение и настройка Liquibase

2. Расширение JPA модели и написание скриптов миграции БД

Первая задача — это подключение и настройка Liquibase к Spring Boot приложению с уже разработанной ранее JPA моделью. В процессе решения этой задачи, помимо добавления необходимой зависимости и настройки файла`application.properties`, нам также потребуется создать скрипт инициализации базы данных.

Дляудобноговзаимодействия с PostgreSQLжелательно наличие сервиса pgAdmin. Amplicode предлагает pgAdmin в списке рекомендуемых сервисов, так как видит сервис PostgreSQL в текущем файле. Чтобы воспользоваться этой возможностью, нажмите на иконку в виде лампочки и выберите**Add pgAdmin service** в появившемся меню:

Для взаимодействия с PostgreSQLбыло бы удобно иметь также сервис pgAdmin. Amplicode предлагает pgAdmin в списке рекомендуемых сервисов, так как видит сервис PostgreSQL в текущем файле. Чтобы воспользоваться этой возможностью, нажмите на иконку в виде лампочки и выберите**Add pgAdmin service** в появившемся меню:

Откроется всплывающий диалог**Add pgAdmin to Docker Compose**. Чтобы воспользоваться предоставленной Amplicode возможностью для настройки автоматического подключения PostgreSQL к pgAdmin:

*Пометьте чекбокс**Configure DB server connections**

*Отметьте чекбокс**Configure DB server connections**

* Оставьте значения всех остальных параметров по умолчанию

* Нажмите**OK**.

На данный момент база данных находится в том же состоянии, что и JPA модель. Переходим крешению поставленной задачи.

На данный момент база данных находится в том же состоянии, что и JPA модель. Переходим кподключению Liquibase к нашему приложению.

Amplicode Explorer позволяет добавить необходимые стартеры и библиотеки к проекту. Для этого необходимо:

* Щелкнуть правой кнопкой мыши по узлу**Configuration**

* Отметить чекбоксы**Create init DB scripts** и**Run changelog-sync**.

Первый чекбокс автоматически перенаправит наск окну генерации скрипта базы данных. Благодарявторому чекбоксуAmplicode выполнит команду Liquibase`changelog-sync`, котораяпозволит отметить скрипты как выполненные, при этом фактически их не выполняя, т.к. все, что в них описано, уже есть в базе данных.

Благодаря выбору первого чекбокса произойдет автоматическое перенаправлениек окну генерации скрипта базы данных. Благодарявыбору второго чекбоксаAmplicode выполнит команду Liquibase`changelog-sync`сразу после генерации скриптов инициализации базы данных. Эта командапозволит отметить скрипты как выполненные, при этом фактически их не выполняя, т.к. все, что будет в них описано, уже есть в базе данных.

* В качестве источника данных для генерации скрипта инициализации выберем базу данных. Для анализа ее структуры Amplicode потребуется подключение к базе данных.

* Выбрать опцию создания нового подключения.

* Нажмите**Test Connection**, чтобы проверить подключение. После этого нажмите**OK**.

* Нажмите**OK** также в главном диалоговом окне.

* Amplicode добавит необходимые зависимости и свойства в`application.properties`, сгенерирует файл`db.changelog-master.xml` и начнет процесс генерации скрипта инициализации базы данных. В открывшемся окне**Change Preview** мы можем изменить расположение, тип и другие параметры файла, а также убедиться в корректности всего файла и его отдельных changeset'ов.

* Amplicode добавит необходимые зависимостив`build.gradle`и свойства в`application.properties`, сгенерирует файл`db.changelog-master.xml` и начнет процесс генерации скрипта инициализации базы данных. В открывшемся окне**Change Preview** мы можем изменить расположение, тип и другие параметры файла, а также убедиться в корректности всего файла и его отдельных changeset'ов.