
운영 중인 서비스에서 사용자 이름을 저장하는 name 컬럼을 display_name으로 바꾼다고 가정해 보자. DB에서 컬럼 이름을 바꾸고, 애플리케이션 쿼리도 새 이름에 맞춰 배포한다. 코드에서 바뀌는 부분만 보면 작은 작업이다.
배포 직후 새 버전에서 다른 문제가 발견됐다. 평소처럼 앱을 직전 버전으로 되돌리면 될까? 구버전은 여전히 name을 읽는다. DB에는 display_name만 남아 있다. 앱이 정상적으로 기동하더라도, 사용자 정보를 조회하는 순간 쿼리가 실패할 수 있다.
이 글에서는 이 가상의 배포를 놓고, 어느 단계까지 앱만 되돌릴 수 있는지 살펴보려고 한다.
앱을 되돌렸을 때 남는 것
Kubernetes Deployment를 이전 리비전으로 롤백하면 Deployment의 Pod 템플릿이 돌아간다. 배포 과정에서 이미 실행한 DB 마이그레이션과 그 이후에 저장된 데이터는 그대로 남는다. 앱이 이전 이미지로 기동했다는 걸 확인했더라도, 복구를 판단하려면 그 버전이 현재 DB에서 필요한 쿼리를 실행할 수 있는지까지 고려해야 한다. Kubernetes Deployment 문서
PostgreSQL에서 RENAME COLUMN은 저장된 값을 바꾸지 않는다. 값은 그대로 있고, 쿼리에서 참조하는 이름이 바뀐다. 그래서 단순히 이름만 바꾼 경우라면, 새 이름을 쓰는 프로세스를 정리하고 컬럼 이름을 다시 돌려 구버전을 복구할 수 있다. 이때 이름을 되돌리는 작업 자체가 새 버전에서 저장한 값을 지우지는 않는다. 다만 새 버전이나 배치가 아직 display_name을 참조하고 있다면, 이름을 되돌리는 순간 그쪽 쿼리가 실패할 수 있다. 롤링 배포 중 구버전과 신버전이 함께 요청을 받는 환경이라면 처음 이름을 바꿀 때도 같은 문제가 생긴다. PostgreSQL 18 ALTER TABLE 문서, Kubernetes 롤링 업데이트 문서
두 컬럼을 남겼을 때 생기는 문제
그러면 기존 name을 그대로 두고 display_name을 추가하면 어떨까. 기존 값을 새 컬럼에 복사하고, 새 버전은 display_name을 읽고 쓰도록 바꾼다. 이제 앱을 되돌려도 구버전의 쿼리는 실행된다.
문제는 이름을 수정한 뒤에 드러난다. 전환 직후 두 컬럼의 값이 모두 민수였다고 하자. 새 버전에서 이름을 민준으로 변경했는데 display_name만 갱신한다면, 앱 롤백 후에는 구버전이 name에 남은 민수를 보여준다. 조회 API는 200을 반환하고 화면도 정상적으로 열린다. 사용자가 마지막으로 저장한 이름만 빠져 있다.
반대 방향도 고려해야 한다. 롤백한 구버전에서 다시 이름을 수정하면 이번에는 name만 갱신될 수 있다. 그 상태에서 새 버전을 다시 배포하면 display_name에 남은 값이 표시된다. 롤백 직후 조회 한 번이 성공해도, 롤백한 상태에서 쓰기를 받고 다시 배포하는 과정은 별도로 확인해야 한다.
읽는 곳과 쓰는 곳을 바꾸는 순서
이 예제에서는 name을 한동안 기준으로 유지하는 편이 흐름을 이해하기 쉽다. display_name을 추가한 뒤, 먼저 읽기는 name에서 계속 하고 쓰기는 두 컬럼을 같은 트랜잭션에서 갱신하는 버전을 배포한다. 전환 중에는 구버전이 여전히 name만 쓸 수 있으므로, 이 시점에 새 컬럼의 값을 기준으로 읽기 시작하면 안 된다.
name만 쓰는 앱과 작업이 모두 빠졌다면 기존 행에 display_name을 채운다. 운영 중에 데이터를 채워 넣는 작업을 보통 백필(backfill)이라고 부른다. 이때는 NULL인 행만 일괄 복사하면 충분한지부터 고려해야 한다. 두 버전이 공존하던 동안에는 두 컬럼이 모두 채워져 있으면서 값이 다른 행도 생길 수 있다. 백필이 진행되는 사이 사용자가 이름을 바꿀 수도 있으니, 미리 읽어둔 오래된 값으로 최신 값을 덮어쓰지 않도록 갱신 방식도 정해야 한다.
두 값이 맞고 쓰기 경로에서도 계속 함께 갱신되는 걸 확인한 뒤에 display_name으로 읽기를 전환한다. 이 상태에서 앱을 되돌려야 한다면, name을 읽으면서 두 컬럼을 같이 쓰던 버전으로 돌아가는 편이 다루기 쉽다. name만 쓰던 버전까지 되돌리면 두 값이 다시 달라질 수 있어서, 신버전을 올리기 전에 데이터 정합성을 다시 확인해야 한다.
이 방식은 한 번에 컬럼 이름을 바꾸는 것보다 배포 단계가 늘어난다. 동시에 두 컬럼을 관리해야 하고 백필도 필요하다. 쓰기를 잠시 멈출 수 있는 서비스라면, 전환 시간 동안 관련 프로세스를 정지하고 컬럼 이름과 앱 버전을 함께 바꾸는 방식도 가능하다. 어느 쪽이 적절한지는 전환 중에도 쓰기를 계속 받아야 하는지, 그리고 구버전과 신버전이 얼마나 오래 공존하는지에 따라 달라진다.
기존 컬럼을 지우는 시점
현재 배포된 앱이 모두 display_name을 읽는다는 것만으로는 name을 지울 시점을 정하기 어렵다. 그 컬럼을 아직 읽는 배치가 있는지, 장애가 나면 어느 앱 버전으로 돌아갈 예정인지도 확인해야 한다. 앞에서 롤백 대상으로 잡은 버전은 여전히 name을 읽고, 두 컬럼에 모두 쓴다. 그 버전으로 돌아갈 가능성을 열어둔 상태에서 name을 지우면 준비해 둔 복구 경로가 사라진다.
그래서 기존 컬럼 제거는 읽기 전환과 별도 배포로 잡는 편이 좋다. 제거 전에 현재 실행 중인 코드와 롤백 후보 모두가 기존 컬럼 없이 동작할 수 있는지 확인할 수 있기 때문이다. 지운 뒤에 문제가 생겼다면 현재 스키마에서 동작하는 버전으로 수정 배포할지, 기존 컬럼을 다시 만들어 값을 복구할 수 있을지 판단해야 한다. 이 예제처럼 같은 의미의 값을 다른 컬럼에 보관했다면 복원이 가능할 수 있지만, 삭제한 데이터가 다른 곳에 남아 있지 않다면 얘기가 달라진다.
백업이나 시점 복구(PITR)도 별개의 선택지다. 배포 직전으로 복구한 DB에는 그 시점 이후에 커밋된 쓰기가 포함되지 않는다. 운영 DB를 복구본으로 교체한다면 배포 이후에 정상적으로 처리된 변경을 어떻게 보존하거나 반영할지까지 고려해야 한다. PostgreSQL 18 시점 복구 문서
이 예제에서 배포 전에 적어둘 문장은 구체적이다. “name 컬럼을 제거하기 전까지는 두 컬럼을 함께 갱신하는 버전으로 앱만 되돌릴 수 있다.” 컬럼 제거를 별도로 배포한다면, 그 배포에는 롤백 대상 버전과 복구 절차도 새로 적어야 한다.
틀린 내용이나 궁금한 점은 댓글로 남겨주세요.