[java] Liquibase를 사용하여 자바 애플리케이션의 데이터베이스 크롤링 관리하기

29 Nov 2023

java

소개

Liquibase는 자바 기반의 오픈 소스 데이터베이스 마이그레이션 도구입니다. 이 도구를 사용하면 자바 애플리케이션의 데이터베이스 크롤링을 쉽게 관리할 수 있습니다. 데이터베이스 스키마 변경 및 마이그레이션 작업을 간편하게 수행할 수 있으며, 변경 사항을 버전 관리하여 여러 환경에서 일관된 데이터베이스를 유지할 수 있습니다.

Liquibase 사용 방법

1. 의존성 추가하기

먼저, Maven이나 Gradle과 같은 빌드 도구를 사용하여 프로젝트에 Liquibase의 의존성을 추가해야 합니다. Maven을 사용하는 경우, pom.xml 파일에 다음 의존성을 추가합니다:

<dependency>
    <groupId>org.liquibase</groupId>
    <artifactId>liquibase-core</artifactId>
    <version>4.4.1</version>
</dependency>

Gradle을 사용하는 경우, build.gradle 파일에 다음 의존성을 추가합니다:

implementation 'org.liquibase:liquibase-core:4.4.1'

2. 변경 사항 정의하기

Liquibase를 사용하여 데이터베이스 변경 작업을 수행하기 위해서는 변경 사항을 정의해야 합니다. 변경 사항은 XML 또는 YAML 형식으로 작성할 수 있으며, 보다 구조화된 변경 사항 관리를 위해서는 Java 코드로도 작성할 수 있습니다.

예를 들어, changelog.xml 파일을 생성하고 다음과 같이 변경 사항을 정의할 수 있습니다:

<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                   xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
                   http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.4.xsd">

    <changeSet id="1" author="John Doe">
        <createTable tableName="users">
            <column name="id" type="INT" autoIncrement="true" primaryKey="true"/>
            <column name="name" type="VARCHAR(50)"/>
        </createTable>
    </changeSet>

    <changeSet id="2" author="Jane Smith">
        <addColumn tableName="users">
            <column name="email" type="VARCHAR(100)"/>
        </addColumn>
    </changeSet>

</databaseChangeLog>

3. 변경 사항 적용하기

변경 사항을 정의한 이후에는 Liquibase를 사용하여 데이터베이스에 변경 사항을 적용할 수 있습니다. 이 때, Liquibase 클래스의 인스턴스를 생성하고 update() 메서드를 호출하면 됩니다.

import liquibase.Liquibase;
import liquibase.database.Database;
import liquibase.database.DatabaseFactory;
import liquibase.database.core.H2Database;
import liquibase.database.jvm.JdbcConnection;
import liquibase.exception.DatabaseException;
import liquibase.exception.LiquibaseException;
import liquibase.resource.ClassLoaderResourceAccessor;

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

public class DatabaseMigration {

    public static void main(String[] args) {
        try (Connection connection = DriverManager.getConnection("jdbc:h2:mem:test", "username", "password")) {
            Database database = DatabaseFactory.getInstance().findCorrectDatabaseImplementation(new JdbcConnection(connection));

            Liquibase liquibase = new Liquibase("changelog.xml", new ClassLoaderResourceAccessor(), database);
            liquibase.update("");
        } catch (SQLException | LiquibaseException e) {
            e.printStackTrace();
        }
    }
}

위의 예제에서는 H2 메모리 데이터베이스를 사용했지만, 실제 프로젝트에서는 사용하는 데이터베이스에 맞게 수정해야 합니다.

결론

Liquibase를 사용하면 자바 애플리케이션의 데이터베이스 크롤링 관리가 훨씬 간편해집니다. 변경 사항을 버전 관리하고 일관된 데이터베이스를 유지할 수 있으며, 롤백 및 변경 이력 추적을 위한 기능도 제공합니다.

더 자세한 정보를 원하신다면 Liquibase 공식 문서를 참고하시기 바랍니다.