목록 보기
TypeORM으로 데이터베이스 마이그레이션하기
백엔드

TypeORM으로 데이터베이스 마이그레이션하기

모두싸인
모두싸인
2021년 11월 30일

두줄요약

TypeORM 마이그레이션으로 스키마 변경·롤백 쿼리 생성과 이력 관리를 자동화했습니다. 실행 순서와 DB 벤더별 DDL 트랜잭션 특성에 주의해야 합니다.

문제 상황

  • 수동 마이그레이션·롤백 쿼리 작성에 따른 작업 비용과 실수 위험
  • 빈번한 DB 스키마 변경 이력 추적의 어려움
  • 프로덕션 스키마 변경 시 권한 요청과 수동 작업의 운영 부담

해결 방법

  • TypeORM generate로 엔티티와 현재 스키마의 차이 기반 up·down 쿼리 자동 생성
  • 마이그레이션 파일의 시간순 관리로 스키마 변경 내역 추적
  • 지속적 배포 흐름에 마이그레이션을 통합해 스키마 관리 자동화

구조와 흐름

  • 적용 이력이 없는 파일 선별 후 타임스탬프 오름차순으로 up 메서드 실행
  • 트랜잭션 단위 옵션 ALL·EACH·NONE을 통한 실행 범위 설정
  • MySQL의 DDL 암묵적 커밋 환경에서 스택 기반 수동 롤백 처리

주의할 점

  • 이미 적용된 마이그레이션과 신규 파일의 시간 역전 시 최종 스키마 상태 변화 가능성
  • 동일 스키마 동시 변경에 따른 충돌 관리 필요
  • DDL 트랜잭션 지원 여부에 따른 벤더별 롤백 동작 차이

다음 읽기

같은 회사의 연관 글

NestJS v10 업데이트의 여정

NestJS v10 업데이트 과정에서 주요 변경점과 호환성 문제를 정리했습니다. 공통 라이브러리와 토큰 매핑을 활용해 점진적으로 마이그레이션하는 방법을 소개했습니다.

모두싸인
모두싸인
백엔드
전체 보기

댓글 0개

댓글을 작성하려면 로그인이 필요합니다.

댓글을 불러오는 중...