데이터베이스 마이그레이션: Flyway로 스키마 버전 관리하기

// build.gradle
dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.flywaydb:flyway-core'
    runtimeOnly 'com.mysql:mysql-connector-j'
}

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb
    username: user
    password: password

  flyway:
    enabled: true                           # Flyway 활성화 (기본: true)
    baseline-on-migrate: true               # 기존 DB에 Flyway 적용 시
    locations: classpath:db/migration       # 마이그레이션 파일 위치
    sql-migration-prefix: V                 # 버전 파일 접두사
    sql-migration-separator: __             # 구분자
    sql-migration-suffixes: .sql            # 파일 확장자
    validate-on-migrate: true               # 실행 전 검증

CREATE TABLE users (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

CREATE INDEX idx_username ON users(username);

ALTER TABLE users
ADD COLUMN email VARCHAR(255);

ALTER TABLE users
ADD CONSTRAINT uk_email UNIQUE (email);

CREATE TABLE orders (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    user_id BIGINT NOT NULL,
    amount DECIMAL(10, 2) NOT NULL,
    status VARCHAR(20) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (user_id) REFERENCES users(id)
);

CREATE INDEX idx_user_id ON orders(user_id);
CREATE INDEX idx_created_at ON orders(created_at);

-- 기존 데이터 업데이트
UPDATE users
SET email = CONCAT(username, '@example.com')
WHERE email IS NULL;

-- 기본값 설정 후 NOT NULL 제약 추가
ALTER TABLE users
MODIFY COLUMN email VARCHAR(255) NOT NULL;

-- 1. 새 컬럼 추가
ALTER TABLE users
ADD COLUMN status VARCHAR(20);

-- 2. 기존 데이터 마이그레이션
UPDATE users
SET status = CASE
    WHEN deleted_at IS NOT NULL THEN 'DELETED'
    WHEN email_verified = 1 THEN 'ACTIVE'
    ELSE 'PENDING'
END;

-- 3. NOT NULL 제약 추가
ALTER TABLE users
MODIFY COLUMN status VARCHAR(20) NOT NULL;

-- 4. 기존 컬럼 제거 (선택적)
-- ALTER TABLE users
-- DROP COLUMN deleted_at,
-- DROP COLUMN email_verified;

# Spring Boot 애플리케이션 시작 시 자동 실행
./gradlew bootRun

# 로그:
# Flyway: Migrating schema `mydb` to version "1 - create users table"
# Flyway: Migrating schema `mydb` to version "2 - add email to users"
# Flyway: Successfully applied 2 migrations

-- flyway_schema_history 테이블 조회
SELECT
    installed_rank,
    version,
    description,
    type,
    script,
    checksum,
    installed_on,
    execution_time,
    success
FROM flyway_schema_history
ORDER BY installed_rank;

-- 결과:
-- rank | version | description           | script                      | installed_on        | success
-- 1    | 1       | create users table    | V1__create_users_table.sql  | 2025-12-16 10:00:00 | 1
-- 2    | 2       | add email to users    | V2__add_email_to_users.sql  | 2025-12-16 10:00:01 | 1

ALTER TABLE users
ADD COLUMN email VARCHAR(255);

ALTER TABLE users
DROP COLUMN email;

-- 1. 문제가 된 마이그레이션 확인
SELECT * FROM flyway_schema_history
WHERE success = 0;

-- 2. 수동으로 롤백 SQL 실행
ALTER TABLE users
DROP COLUMN email;

-- 3. flyway_schema_history에서 해당 레코드 삭제 (주의!)
DELETE FROM flyway_schema_history
WHERE version = '2';

-- 4. 마이그레이션 파일 수정 후 재실행

# application-dev.yml
spring:
  flyway:
    clean-disabled: false  # clean 허용 (전체 삭제)
    baseline-on-migrate: true

# application-prod.yml
spring:
  flyway:
    clean-disabled: true   # clean 금지 (안전)
    validate-on-migrate: true
    out-of-order: false    # 순서 엄격히 적용

-- 테스트 데이터 (테스트 환경에서만)
INSERT INTO users (username, email) VALUES
('alice', 'alice@test.com'),
('bob', 'bob@test.com');

INSERT INTO orders (user_id, amount, status) VALUES
(1, 100.00, 'COMPLETED'),
(2, 200.00, 'PENDING');

# 운영 DB 마이그레이션 전 백업
mysqldump -u user -p mydb > backup_before_migration.sql

# 마이그레이션 실행
./gradlew bootRun

# 문제 발생 시 복구
mysql -u user -p mydb < backup_before_migration.sql

-- ❌ 나쁜 예 (재실행 시 에러)
CREATE TABLE users (...);

-- ✅ 좋은 예 (재실행 가능)
CREATE TABLE IF NOT EXISTS users (...);

-- 컬럼 추가 (안전)
ALTER TABLE users
ADD COLUMN IF NOT EXISTS email VARCHAR(255);

-- 인덱스 추가 (안전)
CREATE INDEX IF NOT EXISTS idx_email ON users(email);

-- DDL은 자동 커밋됨 (MySQL)
-- 여러 DDL을 하나의 트랜잭션으로 묶을 수 없음

-- ✅ 하나의 파일에 관련 작업만
V2__add_email.sql:
ALTER TABLE users ADD COLUMN email VARCHAR(255);
CREATE INDEX idx_email ON users(email);

-- V5__add_user_status.sql

/**
 * [JIRA-123] 사용자 상태 관리 기능 추가
 *
 * 변경 내용:
 * - users 테이블에 status 컬럼 추가
 * - 기존 deleted_at, email_verified 컬럼을 status로 통합
 *
 * 작성자: Alice
 * 작성일: 2025-12-16
 */

ALTER TABLE users
ADD COLUMN status VARCHAR(20);

-- 기존 데이터 마이그레이션
UPDATE users ...