[java] Flyway를 사용한 Java 애플리케이션의 데이터베이스 히스토리 관리 전략

29 Nov 2023

java

이 글에서는 Flyway를 사용하여 Java 애플리케이션의 데이터베이스 히스토리 관리 전략에 대해 알아보겠습니다.

Flyway란?

Flyway는 데이터베이스 마이그레이션 도구로서, 개발자가 애플리케이션의 데이터베이스 스키마를 버전 관리할 수 있게 해줍니다. Flyway는 간편한 스키마 마이그레이션 프로세스를 제공하여 개발자가 애플리케이션의 데이터베이스 변경 사항을 관리할 수 있도록 도와줍니다.

Flyway의 특징

간단한 설정: Flyway는 간편한 설정을 통해 데이터베이스 연결 및 마이그레이션 경로 등을 설정할 수 있습니다.
버전 관리: Flyway는 각 마이그레이션 스크립트에 고유한 버전 번호를 부여하여 스키마의 버전을 관리합니다.
반복 가능한 마이그레이션: Flyway는 한 번 실행된 마이그레이션 스크립트를 다시 실행하지 않으므로, 반복적인 마이그레이션에 안전합니다.
자동 마이그레이션: Flyway는 애플리케이션이 시작될 때 자동으로 데이터베이스 마이그레이션을 실행할 수 있습니다.
다양한 데이터베이스 지원: Flyway는 MySQL, PostgreSQL, Oracle, SQL Server 등 다양한 데이터베이스를 지원합니다.

Flyway를 사용한 데이터베이스 히스토리 관리 전략

Flyway를 사용하여 데이터베이스 히스토리 관리를 구현하는 전략은 다음과 같습니다:

1. 마이그레이션 스크립트 작성

데이터베이스 마이그레이션 스크립트를 작성합니다. 각 스크립트는 특정 버전 번호와 함께 파일 이름으로 저장됩니다. 스크립트는 DDL(Data Definition Language) 문이 포함되어 있어야 합니다.

예를 들어, V1__Create_Table.sql과 같은 파일 이름으로 스크립트를 작성할 수 있습니다.

-- V1__Create_Table.sql
CREATE TABLE customer (
    id INT PRIMARY KEY,
    name VARCHAR(100)
);

2. 데이터베이스 마이그레이션 폴더 설정

Flyway는 마이그레이션 스크립트를 어떤 폴더에서 찾아야 하는지 설정해야 합니다. 보통 애플리케이션의 클래스 패스에 있는 db.migration 폴더를 사용합니다.

3. Flyway 설정

Java 애플리케이션에서 Flyway를 사용하려면 Maven 또는 Gradle과 같은 빌드 도구를 사용하여 Flyway 종속성을 추가해야 합니다.

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

또한 자바 코드에서 Flyway를 설정하는 코드도 작성해야 합니다.

Flyway flyway = Flyway.configure()
    .dataSource(url, username, password)
    .locations("db.migration")
    .load();

4. 애플리케이션 실행 시 마이그레이션 실행

Java 애플리케이션이 시작될 때 Flyway를 사용하여 자동으로 데이터베이스 마이그레이션을 실행할 수 있습니다.

flyway.migrate();

매번 애플리케이션이 시작될 때마다 Flyway가 마이그레이션을 실행하므로, 데이터베이스 스키마는 항상 최신 상태를 유지할 수 있습니다.

마무리

Flyway를 사용하면 Java 애플리케이션의 데이터베이스 히스토리 관리를 손쉽게 구현할 수 있습니다. Flyway를 이용하면 데이터베이스 마이그레이션을 자동화하고, 데이터베이스 스키마 변경을 관리할 수 있습니다. Flyway의 강력한 기능과 다양한 데이터베이스 지원으로 인해 개발자들은 데이터베이스 버전 관리에 대해 걱정할 필요가 없습니다.

더 자세한 정보는 Flyway 공식 문서를 참고하세요.