[java] Flyway를 사용한 Java 애플리케이션의 데이터베이스 병렬 마이그레이션

29 Nov 2023

java

많은 Java 애플리케이션들이 데이터베이스를 사용하여 데이터를 저장하고 관리하고 있다. 하지만 때로는 애플리케이션의 요구사항이 변경되어 데이터베이스 스키마를 수정하는 경우가 발생하기도 한다. 이런 경우에는 마이그레이션 작업을 통해 데이터베이스를 업데이트해야 한다.

Flyway는 데이터베이스 마이그레이션을 관리하기 위한 도구로, Java 애플리케이션에서 사용할 수 있다. Flyway는 간단하면서도 강력한 기능을 제공하며, 데이터베이스 스키마와 데이터를 안전하게 업데이트할 수 있는 방법을 제공한다.

Flyway의 주요 특징

1. 간단한 설정

Flyway는 간단한 설정을 통해 마이그레이션 작업을 시작할 수 있다. 우선적으로, 프로젝트의 설정 파일에 데이터베이스 연결 정보와 마이그레이션 파일의 위치를 지정해야 한다. 설정 파일은 다양한 형식의 파일로 작성할 수 있으며, Flyway는 대표적으로 flyway.conf 또는 flyway.properties 파일을 지원한다.

2. 버전 관리

Flyway는 마이그레이션 파일들을 버전 관리하기 위해 간단한 규칙을 따른다. 마이그레이션 파일은 일련의 이름 규칙을 가지며, 파일 이름에 포함된 버전 정보를 기반으로 마이그레이션 순서를 관리한다. 이를 통해 마이그레이션 파일들을 순차적으로 실행할 수 있다.

3. 롤백 기능

Flyway는 롤백 기능을 지원하여 실패한 마이그레이션 작업을 취소할 수 있다. 롤백은 마이그레이션 파일의 실행 순서와 반대로 진행된다. 롤백 후에는 이전 버전의 스키마와 데이터로 되돌릴 수 있다.

4. 다중 스레드로 실행

Flyway는 마이그레이션 파일을 병렬로 실행하는 기능을 제공한다. 이렇게 하면 병렬로 여러 개의 마이그레이션 파일을 동시에 실행할 수 있어서 빠른 데이터베이스 업데이트를 가능하게 한다.

Java 애플리케이션에서의 Flyway 사용

Flyway를 Java 애플리케이션에서 사용하기 위해서는 몇 가지 단계를 거쳐야 한다.

1. Flyway 라이브러리 추가

먼저, Maven, Gradle 등의 빌드 도구를 사용하여 프로젝트에 Flyway 라이브러리를 추가해야 한다. Maven의 경우, pom.xml 파일에 다음과 같은 의존성을 추가한다:

<dependencies>
    <!-- other dependencies -->
    <dependency>
        <groupId>org.flywaydb</groupId>
        <artifactId>flyway-core</artifactId>
        <version>7.0.1</version>
    </dependency>
</dependencies>

2. 마이그레이션 파일 작성

Flyway는 마이그레이션 파일들의 위치와 규칙을 기반으로 마이그레이션을 실행한다. 마이그레이션 파일은 SQL 또는 Java 코드로 작성될 수 있다. SQL 파일의 경우에는 데이터베이스 스크립트가 작성되어야 하며, Java 파일의 경우에는 Migration 인터페이스를 구현하여 스크립트를 실행할 수 있다.

예를 들어, Flyway가 기본적으로 db/migration 폴더를 마이그레이션 파일의 위치로 인식한다고 가정하자. 그렇다면 V1__Create_table.sql 과 같은 형식의 파일을 생성하여 첫 번째 마이그레이션을 작성할 수 있다.

3. 애플리케이션에 Flyway 설정 추가

마지막으로, Flyway 설정을 애플리케이션에 추가해야 한다. 보통 Spring Framework나 Spring Boot를 사용하는 경우에는 application.properties 또는 application.yml 파일에 데이터베이스 연결 정보와 Flyway 설정을 작성할 수 있다.

예를 들어, application.properties 파일에 다음과 같은 설정을 추가할 수 있다:

spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=secret

spring.flyway.enabled=true

4. Flyway 실행

이제 Java 애플리케이션을 실행하면 Flyway가 자동으로 마이그레이션 작업을 실행한다. Flyway는 설정된 위치의 마이그레이션 파일들을 실행하여 데이터베이스를 업데이트한다. 실행 중에는 마이그레이션 상태에 대한 로그가 출력되며, 마이그레이션 작업이 완료되면 애플리케이션 실행이 진행된다.

결론

Flyway는 Java 애플리케이션에서 데이터베이스 병렬 마이그레이션을 쉽게 수행할 수 있는 강력한 도구이다. 간단한 설정과 버전 관리 기능을 통해 안정적인 마이그레이션 작업을 할 수 있으며, 롤백과 병렬 실행 기능을 통해 유연하고 빠른 데이터베이스 업데이트를 가능케 한다.

Flyway는 개발자들이 데이터베이스 스키마를 신속하게 변경하고 유지보수하는 데 큰 도움을 줄 수 있는 도구이다. Java 애플리케이션에서 Flyway를 사용하여 데이터베이스를 업데이트하면, 안전하고 효과적인 개발 프로세스를 구축할 수 있다.

참고 자료

Flyway 공식 홈페이지: https://flywaydb.org/
Flyway Github 저장소: https://github.com/flyway/flyway