스킬 파일

Db Migration

Name: Db Migration
Author: VelkaressiaBlutkrone

데이터베이스 마이그레이션 SQL 스크립트를 생성하는 스킬. "/db-migration"을 입력하거나, "마이그레이션 스크립트 만들어줘", "테이블 변경 SQL", "DB 스키마 변경" 같은 요청에 트리거된다. ERD 문서와 JPA Entity를 비교하여 안전한 마이그레이션 스크립트를 생성한다.

VelkaressiaBlutkrone0 스타2026. 3. 20.

직업
카테고리: 데이터베이스 도구

스킬 내용

DB 마이그레이션 스크립트 생성

ERD 문서와 JPA Entity 간 차이를 분석하여 MySQL 마이그레이션 SQL을 생성하는 스킬이다.

사전 확인

doc/ERD.md — 현재 ERD 정의
doc/ERD_ALIGNMENT.md — ERD 정합 계획
doc/ERD_NON_STANDARD_TABLES.md — ERD에 없는 테이블
src/main/java/com/sample/llm/entity/ — 현재 JPA Entity
src/main/resources/application.yml — ddl-auto 설정 확인

스크립트 작성 원칙

안전 제일

-- 항상 트랜잭션으로 감싸기
START TRANSACTION;

-- 변경 작업 ...

COMMIT;

롤백 스크립트 동시 작성

모든 마이그레이션에는 롤백 SQL도 함께 작성한다:

관련 스킬

Db Migration | Skills Pool

-- ========== ROLLBACK ==========
-- START TRANSACTION;
-- (역방향 작업)
-- COMMIT;

-- {old_table} → {new_table}
ALTER TABLE {old_table} RENAME TO {new_table};

ALTER TABLE {table}
    CHANGE COLUMN {old_column} {new_column} {TYPE} {CONSTRAINTS};

-- 기존 FK 제거
ALTER TABLE {table} DROP FOREIGN KEY {fk_name};

-- 새 FK 추가
ALTER TABLE {table}
    ADD CONSTRAINT {new_fk_name}
    FOREIGN KEY ({column}) REFERENCES {ref_table}({ref_column});

ALTER TABLE {table}
    ADD COLUMN {column} {TYPE} NULL AFTER {after_column};

-- 새 컬럼에 기본값 채우기
UPDATE {table} SET {column} = {default_value} WHERE {column} IS NULL;

scripts/
├── {기능명}-migration.sql          # 마이그레이션
└── {기능명}-migration-rollback.sql  # 롤백 (선택)

Db Migration

DB 마이그레이션 스크립트 생성

사전 확인

스크립트 작성 원칙

안전 제일

롤백 스크립트 동시 작성

Db Migration

DB 마이그레이션 스크립트 생성

사전 확인

스크립트 작성 원칙

안전 제일

롤백 스크립트 동시 작성

데이터 보존 우선

마이그레이션 유형별 템플릿

테이블 리네이밍

컬럼 리네이밍

FK 변경

컬럼 추가 (nullable)

초기 데이터 업데이트

파일 위치 및 네이밍

동작 순서

Step 1: 차이 분석

Step 2: 의존성 확인

Step 3: SQL 생성

Step 4: Entity 동기화

Step 5: 문서 갱신

주의사항

Database Migrations

Database Migrations

Postgres Patterns

Frontend Query & Mutation

Db Migrations

Drizzle

변경 유형	대상	현재	목표
RENAME TABLE	...	...	...
ADD COLUMN	...	—	...
CHANGE COLUMN	...	...	...