운영 중 데이터베이스 마이그레이션: 먼저 확장하고 나중에 축소하며, 롤백 경계를 분명히

핵심 요약: 운영 스키마를 바꿀 때 위험한 것은 대개 SQL 자체가 아니라 신구 두 버전의 코드가 나란히 도는 기간입니다. 우리는 확장-축소(expand-contract)로 진행합니다. 지우지 않고 추가만 해서 두 버전이 모두 동작하게 하고, 과거 데이터를 배치로 백필하고, 읽기를 전환하고, 옛 구조를 아무도 쓰지 않는다는 것을 확인한 뒤에야 삭제합니다. 각 단계는 별도 배포입니다. 삭제 전까지는 언제든 롤백할 수 있고, 삭제 후에는 앞으로 고치는 것만 가능합니다.

확장-축소 마이그레이션의 다섯 단계: 확장(새 열 추가), 이중 쓰기(기존과 신규에 모두 쓰기), 백필(배치, 재개 가능), 읽기 전환(신규 읽기와 관찰), 축소(기존 열 쓰기 중지 후 삭제). 축소 앞에 되돌릴 수 없는 지점이 있어, 그 전에는 롤백이 직전 배포를 되돌리는 것이고 그 후에는 앞으로만 고칠 수 있습니다. 5단계 전에 모든 저장소, 보고서, 동기화 작업에서 기존 열을 읽는 곳을 찾습니다.
그림 1. 다섯 번의 배포와 하나의 되돌릴 수 없는 지점. 삭제는 마지막에 단독으로 배포합니다.

1.0 왜 한 번에 끝내지 않는가

롤링 배포 동안 옛 버전 인스턴스는 여전히 요청을 처리하고, 모바일 앱이나 외부 시스템은 옛 인터페이스를 계속 호출할 수 있습니다. 열 이름을 바꾸는 마이그레이션은 아직 내려가지 않은 옛 코드를 즉시 깨뜨립니다. 큰 테이블에 대한 일부 DDL은 잠금을 오래 잡고 있어 일반 요청을 뒤에 줄 세우기도 합니다.

2.0 다섯 단계

단계하는 일되돌릴 수 있나
1 확장새 열이나 테이블을 NULL 허용 또는 기본값과 함께 추가. 옛 구조는 건드리지 않음가능. 새 열을 삭제하면 됨
2 이중 쓰기새 코드가 신구 양쪽에 씀. 읽기는 여전히 옛 구조에서가능. 코드를 되돌림
3 백필과거 데이터를 배치로 새 구조에 기록. 재실행·일시 정지 가능가능
4 읽기 전환읽기를 새 구조로 바꾸고 한동안 관찰. 옛 구조에도 계속 씀가능. 다시 전환
5 축소옛 구조에 쓰기를 멈춘 뒤 삭제삭제 후에는 불가

5단계 전에 한 번 멈추고, 옛 열을 아직 읽는 코드, 보고서, 외부 동기화가 없는지 확인합니다. 우리는 기억이 아니라 모든 저장소 검색과 데이터베이스 접근 로그로 확인합니다.

3.0 백필

  • 기본 키 범위로 나누고, 배치마다 짧은 트랜잭션 하나로 처리하며 배치 사이에 간격을 둡니다. 긴 트랜잭션과 복제 지연을 피하기 위해서입니다.
  • 백필은 재진입 가능하게 만듭니다. 중단돼도 멈춘 위치부터 이어 가고, 두 번 실행해도 결과가 같습니다.
  • 진행 상황과 실패한 행을 기록하고 실패분은 따로 처리해, 잘못된 행 하나가 백필 전체를 막지 않게 합니다.
  • 백필 중의 새 쓰기는 이중 쓰기가 이미 처리하므로 백필은 과거 데이터만 다룹니다.

4.0 테이블을 잠그는 작업

데이터베이스와 버전마다 차이가 크니 시작 전에 공식 문서를 확인합니다. 흔한 경우를 몇 가지 들면 다음과 같습니다.

  • PostgreSQL에서는 CREATE INDEX CONCURRENTLY로 인덱스를 만들어 쓰기를 막지 않습니다. 트랜잭션 블록 안에서는 실행할 수 없고, 실패하면 유효하지 않은 인덱스가 남으므로 지우고 다시 만들어야 합니다.
  • 데이터가 있는 테이블에 NOT NULL 열을 추가할 때는 먼저 NULL 허용으로 추가하고, 백필한 뒤 제약을 겁니다.
  • MySQL은 사용 중인 버전에서 온라인 DDL이 어떤 작업을 어떤 알고리즘으로 지원하는지 확인합니다. 큰 테이블에는 gh-ost 같은 도구도 고려합니다.
  • 마이그레이션 세션에 잠금 대기 타임아웃을 설정합니다. 잠금을 얻지 못하면 실패하고 나중에 재시도하게 해서, 잠금 대기열에 서서 뒤의 요청을 모두 막는 일이 없게 합니다.

5.0 마이그레이션을 CI와 배포 절차에 넣는다

  • 마이그레이션 파일은 순서대로 번호를 붙여 저장소에 둡니다. 이미 배포한 마이그레이션은 고치지 않고, 잘못은 새 마이그레이션으로 바로잡습니다.
  • CI는 두 경로를 돌립니다. 빈 데이터베이스에 모든 마이그레이션을 적용하는 경로와, 직전 배포 시점의 데이터베이스에 새 마이그레이션을 적용하는 경로입니다. 두 경로의 스키마는 같아야 합니다.
  • 배포 전에 운영 데이터를 마스킹한 사본에서 실행해 소요 시간을 기록하고, 한산한 시간대로 미뤄야 할지 판단합니다.
  • 매 마이그레이션 전에 복원 연습을 마친 쓸 수 있는 백업을 둡니다. 한 번도 복원해 보지 않은 백업은 백업이 아닙니다.

기존 시스템에 큰 스키마 변경이 필요하거나 마이그레이션이 자주 말썽이라면 웹·클라우드·디바이스 관리를 참고하거나 프로젝트 상담으로 연락 주세요.

참고 자료

자주 묻는 질문

작은 프로젝트도 이렇게 단계를 나눠야 하나요?

짧은 점검 시간을 받아들일 수 있고 옛 인터페이스에 기대는 클라이언트도 없다면, 서비스를 멈추고 테이블을 바꾸는 편이 더 간단하고 그래도 괜찮습니다. 확장-축소는 멈출 수 없는 시스템이나, 신구 코드가 반드시 동시에 도는 경우를 위한 방법입니다.

이중 쓰기로 데이터가 어긋날 수 있지 않나요?

그럴 위험이 있습니다. 그래서 읽기를 전환하기 전에 신구 데이터를 표본 비교하고, 백필이 끝난 뒤 핵심 필드를 한 번 더 전수 비교합니다. 두 쓰기를 같은 트랜잭션에 넣을 수 있다면 같은 트랜잭션에 넣습니다.

ORM이 자동 생성한 마이그레이션을 그대로 써도 되나요?

초안으로는 괜찮지만, 배포 전에 생성된 SQL을 사람이 읽어 봐야 합니다. 특히 이름 변경, 타입 변경, 삭제가 그렇습니다. 도구는 이름 변경을 '열 삭제 후 추가'로 만들어 버리곤 하고, 그러면 데이터가 사라집니다.

마이그레이션이 중간에 실패하면 어떻게 하나요?

5단계 이전이라면 직전 배포를 되돌리면 원래 상태로 돌아갑니다. 이미 삭제한 구조는 백업에서 복원하거나 앞으로 고치는 수밖에 없습니다. 그래서 삭제는 마지막에, 단독 배포로, 충분한 관찰 기간 뒤에 합니다.