[java] Flyway와 Java 프로젝트의 데이터베이스 배치 상태 관리 전략

29 Nov 2023

java

소개

Java 프로젝트에서 데이터베이스를 사용할 때 데이터베이스 스키마의 변경 및 업데이트는 일반적으로 복잡한 작업입니다. Flyway는 데이터베이스 마이그레이션 도구로, 스키마 변경을 관리하고 버전 관리를 쉽게 해줍니다. 이 글에서는 Flyway와 Java 프로젝트에서 데이터베이스 배치 상태 관리 전략에 대해 알아보겠습니다.

Flyway란?

Flyway는 오픈 소스 데이터베이스 마이그레이션 도구로, 데이터베이스 스키마 변경이나 업데이트를 손쉽게 관리할 수 있습니다. Flyway는 각 스키마 변화마다 스크립트를 작성하고 순차적으로 실행하여 데이터베이스의 버전을 관리합니다. Flyway는 버전 변경 이력을 테이블로 관리하고, 이력에 따라 데이터베이스를 업데이트합니다.

Flyway는 명령행 도구로써 사용할 수도 있지만, Java 프로젝트의 의존성에 추가하여 코드 중에 Flyway를 직접 호출할 수도 있습니다.

Java 프로젝트에서 Flyway 사용하기

Java 프로젝트에서 Flyway를 사용하려면 Flyway의 의존성을 프로젝트에 추가해야 합니다. Maven을 사용하는 경우, pom.xml 파일에 다음과 같이 의존성을 추가합니다.

<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
    <version>7.10.0</version>
</dependency>

의존성을 추가한 뒤에는 Flyway를 초기화하고 데이터베이스 마이그레이션을 수행하는 Java 코드를 작성해야 합니다. 예를 들어, 스프링 프레임워크를 사용하는 경우에는 다음과 같이 Flyway 객체를 빈으로 등록하여 사용할 수 있습니다.

@Configuration
public class DatabaseConfig {

    // ...

    @Bean
    public Flyway flyway() {
        Flyway flyway = Flyway.configure()
                .dataSource(dataSource())
                .load();
        flyway.migrate();
        return flyway;
    }

    // ...
}

위의 코드에서 dataSource 메서드는 데이터베이스 연결을 구성하는 빈을 생성하는 메서드입니다. Flyway의 migrate() 메서드를 호출하여 마이그레이션을 실행합니다.

데이터베이스 배치 상태 관리 전략

Flyway는 데이터베이스 마이그레이션을 위해 버전 관리를 지원합니다. 이를 통해 개발자는 코드별로 마이그레이션 버전을 분리하여 스키마 변경을 관리할 수 있습니다. Flyway에서는 마이그레이션 스크립트 파일 이름에 버전에 대한 정보를 포함시켜야 합니다.

Flyway가 디렉토리에서 마이그레이션 스크립트를 찾을 때 정렬 순서는 알파벳 순서입니다. 이러한 정렬 순서를 활용하여 버전 관리를 할 수 있습니다. 예를 들어, V1__Create_table.sql과 V2__Add_column.sql과 같은 스크립트 파일의 이름을 사용할 수 있습니다.

Flyway는 이미 실행된 마이그레이션 스크립트를 기록하기 위해 특정 테이블을 사용합니다. 기본적으로 flyway_schema_history라는 테이블을 생성하여 마이그레이션 이력을 기록합니다. 이를 통해 Flyway는 배치된 마이그레이션 스크립트가 이미 적용되었는지 여부를 파악할 수 있습니다.

결론

Flyway는 Java 프로젝트의 데이터베이스 배치 상태 관리를 쉽게 해주는 도구입니다. Flyway를 사용하면 스키마 변경 및 업데이트를 버전으로 관리할 수 있으며, 개발자는 알맞은 마이그레이션 스크립트를 작성하여 데이터베이스를 업데이트할 수 있습니다. Flyway는 오픈 소스이므로 추가적인 문서나 자료를 참고하여 더 자세히 알아볼 수 있습니다.

참고 자료

Flyway 공식 문서: https://flywaydb.org/documentation/
Flyway GitHub 저장소: https://github.com/flyway/flyway
스프링 부트와 함께 사용하는 Flyway 가이드: https://spring.io/guides/gs/caching/