Flyway – это инструмент с открытым исходным кодом для управления версиями баз данных. Это как мерзавец для баз данных. Flyway позволяет вам писать сценарии SQL для ваших схем и таблиц и изменять их для обеспечения согласованности, а также предлагает возможность отката по мере необходимости.
В этой статье предполагается, что вы в общих чертах знакомы с Spring Boot. Если нет, обратитесь к этому официальному руководству от создателей Spring Boot: Если нет, обратитесь к этому официальному руководству от создателей Spring Boot:
Настройка пролета
При настройке нового проекта Spring Boot вы можете добавить зависимость Flyway через Spring Initializr по адресу https://start.spring.io и добавление пролета в качестве зависимости, как показано ниже:
Если вы работаете с существующим проектом Spring Boot, вы можете просто добавить его вручную в свой pom.xml файл следующим образом:
Добавьте зависимость ядра пролета:
Добавьте плагин Flyway maven (это позволит вам запускать Flyway с помощью Maven):
Выполнение миграций
Как только вы настроите свой pom.xml Теперь вам нужно создать свой первый файл миграции. По умолчанию Flyway проверяет наличие файлов миграции внутри src/main/ресурсы/бд/миграция
. Если вы использовали Spring Initializr для добавления Flyway, этот каталог уже создан для вас. Если нет, создайте этот каталог и добавьте свой первый файл миграции.
Файл миграции должен быть назван так: V1__Создать_первую_таблицу.sql
После создания файла миграции теперь вы можете выполнить следующие команды из корневого каталога вашего проекта:
mvn clean установите
для создания вашего проекта.mvn flyway:миграция
для выполнения миграции(ов).
Распространенные ошибки
[ОШИБКА] Не удалось выполнить цель org.flywaydb:flyway-maven-плагин:6.5.5:миграция (по умолчанию-cli) в проекте flyway-демо: org.flywaydb.core.api. Исключение FlywayException: Не удается подключиться к базе данных. Настройте URL-адрес, пользователя и пароль! - > [Справка 1]
Чтобы устранить эту ошибку, дважды проверьте свой pom.xml в конфигурации плагина Flyway убедитесь, что URL-адрес, имя пользователя и пароль указаны правильно. Кроме того, убедитесь, что база данных, к которой вы пытаетесь получить доступ, существует и что у вас достаточно прав для доступа к ней.Исключение FlywayException: Обнаружена ошибка при переходе на версию 1.0
Обычно это вызвано ошибкой SQL в файле миграции. Чтобы устранить эту ошибку, сначала исправьте ошибку SQL при миграции, а затем выполните следующую команду для исправления миграции:mvn flyway:ремонт
. Как только миграция будет восстановлена, вы можете запуститьmvn flyway:migrate
для повторного запуска миграции.
Оригинал: “https://dev.to/trustbirungi/getting-started-with-flyway-in-spring-boot-po1”