
TypeORM으로 데이터베이스 마이그레이션하기
두줄요약
TypeORM 마이그레이션으로 스키마 변경·롤백 쿼리 생성과 이력 관리를 자동화했습니다. 실행 순서와 DB 벤더별 DDL 트랜잭션 특성에 주의해야 합니다.
문제 상황
- 수동 마이그레이션·롤백 쿼리 작성에 따른 작업 비용과 실수 위험
- 빈번한 DB 스키마 변경 이력 추적의 어려움
- 프로덕션 스키마 변경 시 권한 요청과 수동 작업의 운영 부담
해결 방법
- TypeORM generate로 엔티티와 현재 스키마의 차이 기반 up·down 쿼리 자동 생성
- 마이그레이션 파일의 시간순 관리로 스키마 변경 내역 추적
- 지속적 배포 흐름에 마이그레이션을 통합해 스키마 관리 자동화
구조와 흐름
- 적용 이력이 없는 파일 선별 후 타임스탬프 오름차순으로 up 메서드 실행
- 트랜잭션 단위 옵션 ALL·EACH·NONE을 통한 실행 범위 설정
- MySQL의 DDL 암묵적 커밋 환경에서 스택 기반 수동 롤백 처리
주의할 점
- 이미 적용된 마이그레이션과 신규 파일의 시간 역전 시 최종 스키마 상태 변화 가능성
- 동일 스키마 동시 변경에 따른 충돌 관리 필요
- DDL 트랜잭션 지원 여부에 따른 벤더별 롤백 동작 차이





