본문으로 건너뛰기
인터페이스 언어: 한국어
감사 / Signal

AI의 도움으로 준비한 데이터베이스 마이그레이션에는 복원 시험이 필요하다

AI의 도움으로 준비한 데이터베이스 마이그레이션을 데이터 변경, 참조 백업, 격리된 복원과 중단 조건으로 검수합니다.

본문 언어: 한국어

손 옆의 금빛 장치에 투명한 물방울 모양 물체와 밝은 구체가 매달려 있다.
목차

"문제가 생기면 변경을 되돌리면 됩니다." 정확히 무엇을 되돌릴 것인지 묻기 전까지는 그럴듯하다. 열 이름일까, 삭제된 필드의 내용일까, 그사이에 기록된 접수 건일까? AI가 준비한 스크립트에 되돌리기라고 적힌 부분이 있어도 제목만으로 정보가 복원되지는 않는다. 계획된 변경을 대표하는 자료에서 그 경로가 작동하는지, 언제 사용할 수 있는지 알려져 있는지 확인해야 한다.

데이터베이스 마이그레이션은 구조나 데이터를 통제된 방식으로 변경하는 작업이다. 따라서 명령의 문법이 맞는지만 확인해서는 인수가 끝나지 않는다. 먼저 무엇을 바꾸는지, 어떤 상태에서 시작하는지, 애플리케이션이 어떤 결과를 보아야 하는지 정리하자. 그런 다음 격리된 환경에서 합의한 복원 시험을 수행한다. 이 글은 운영 환경에서 마이그레이션을 수행하지 않으며, 데이터베이스에 그대로 붙여 넣을 수 있는 범용 명령도 제시하지 않는다. 그런 검수를 준비하는 절차를 설명한다.

구조에서는 무엇이, 데이터의 의미에서는 무엇이 바뀌는가?

하나의 일정 설명을 날짜와 메모로 나누려는 가상의 업무 시스템을 생각해 보자. AI는 필드를 추가하고 값을 옮긴 뒤 이전 열을 삭제하자고 제안한다. 이는 겉모습만 바꾸는 한 번의 수정이 아니라 여러 결정이다. 어떤 기록에는 정확한 날짜가 있고 다른 기록에는 ‘배송 확인 후’라는 문장이 있을 수 있다. 새 구조만으로 두 경우에 무엇을 입력할지는 결정되지 않는다.

데이터 지도부터 만들자. 이전 필드, 실제 의미, 새 표현, 데이터 이전 규칙이다. 모호한 값에는 별도의 처리 경로를 정한다. 필수 필드를 채우려고 모델이 날짜를 지어내게 해서는 안 된다. 이런 차이를 대표하는 기록을 검증 세트에 넣고 기대 결과는 업무 책임자와 승인한다. 기술적인 문법 검사로 이 결정을 대신할 수 없다.

관계도 확인하자. 변경되는 기록을 무엇이 참조하는지, 식별자를 어디서 쓰는지, 어떤 보고서가 이전 필드를 읽는지 살핀다. 변경 전후의 기록 수만으로는 부족하다. 두 오류가 숫자상 서로 상쇄될 수 있다. 업무 건수 대신 행을 세는 SQL 쿼리 (폴란드어)는 결과의 의미를 다시 확인할 필요를 보여준다. 마이그레이션에서는 그 의미를 저장된 상태에서도 보존해야 한다.

애플리케이션과의 호환성을 정하자. 기존 버전이 새로운 저장 형식을 읽을 수 있는가? 새 버전이 아직 이전되지 않은 기록을 처리할 수 있는가? 전환 중 어느 버전이 데이터를 쓸 수 있는가? 이 질문들이 배포 순서를 정한다. 이전 코드를 되돌릴 수 있다는 사실만으로 그 코드가 변경된 데이터베이스를 올바르게 처리한다는 뜻은 아니다.

해당 프로세스에 참여한다면 데이터베이스 밖의 파일, 작업 큐, 연동 시스템도 계획에 넣자. 혹시 모른다는 이유로 전체 인프라를 나열할 필요는 없다. 다만 변경이 끝나기 전이나 후에 발생할 수 있는 결과는 볼 수 있어야 한다. 여러 시스템에 걸친 실행이라면 부분 실행으로 생길 수 있는 결과를 정리하자. 에이전트 작업의 부분 실행 (폴란드어)에 관한 글은 그 결과를 어떻게 확인할지 보여준다.

백업으로 실제 상태를 복원할 수 있는가?

PostgreSQL SQL 덤프 문서 (영어)는 데이터베이스를 복원할 수 있는 저장과 별도의 복원 조건을 설명한다. 적절한 역할과 권한의 필요성, 단일 데이터베이스의 백업과 PostgreSQL 설치 전체에 공통인 정보의 차이도 다룬다. 파일이 존재한다는 사실만으로 환경 전체가 복원된 것은 아니다.

검수에서는 합의한 백업을 별도 장소에 실제로 복원하고 확인 대상 데이터를 읽어 달라고 요청하자. 어느 백업을 사용했는지, 무엇을 복원했는지, 어떤 단계를 수동으로 수행했는지, 남은 제한은 무엇인지 기록한다. ‘백업 완료’라는 문구를 이 시험의 결과로 취급하지 말자. 도구가 비슷한 초록색 메시지를 보여주더라도 백업을 만드는 것과 사용하는 것은 별개다.

복원 도구가 오류에 어떻게 반응하는지도 확인하자. PostgreSQL 복원 설명 (영어)은 psql이 기본 설정에서 SQL 오류가 난 뒤에도 스크립트 실행을 계속할 수 있고, 다르게 동작하려면 적절한 설정이 필요하다고 설명한다. 따라서 시험의 전체 결과와 종료 후 상태를 읽어야 한다. 마지막 메시지가 나타났거나 예상한 테이블 일부가 있다는 이유만으로 완전한 복원이라고 결론 내리지 말자.

일정 예제에서는 식별할 수 있는 업무 건을 고르자. 복원 후 테이블 수만 세지 말고 식별자, 내용, 관계를 확인한다. 시험 범위에 포함됐다면 격리된 애플리케이션에서 해당 경로도 열어본다. 인수하는 사람은 유용한 정보를 되찾았는지, 아니면 연결만 가능한 데이터베이스를 얻었는지 알아야 한다.

참조 백업은 시험이 덮어쓸 수 있는 디렉터리와 별도로 보관하자. 접근 권한과 허용할 자료를 정한다. 통제된 데이터는 기밀 운영 데이터를 실수로 AI 도구에 옮기지 않으면서 규칙을 시험할 수 있어야 한다. 격리 조건은 AI 자동화 테스트 환경 (폴란드어)에서 자세히 다룬다. 이름에 ‘test’를 붙여도 연결 대상이 바뀌지는 않는다.

백업을 식별할 때는 파일 해시와 증거 버전 (폴란드어)이 도움이 된다. 해시는 내용의 정확성이나 복원 가능성을 증명하지는 않지만 시험 결과를 실제 사용한 정확한 자료와 연결할 수 있다. 보고서에는 두 판단을 따로 남긴다. 마이그레이션 뒤 새로 만든 백업이 변경 전 참조점을 모르게 대체해서는 안 된다.

복원에 필요한 시간과 시작을 위한 조직상의 조건을 정하자. 백업은 작동하지만 복구가 예정된 서비스 중단 시간보다 오래 걸린다는 결과가 나올 수 있다. 그때 단지 표시를 ‘준비 완료’로 바꾸지 말자. 계획이나 범위, 복원 중 회사의 업무 유지 방식을 바꿀지 결정해야 한다.

트랜잭션 롤백은 어떤 결과를 포함하는가?

PostgreSQL 트랜잭션 소개 (영어)는 작업을 묶고 트랜잭션 안의 변경을 되돌리는 방법을 보여준다. 해당 실행의 특정 시점으로 돌아갈 수 있는 저장점도 설명한다. 특정 시스템의 기능이므로 실제 스크립트와 실행 방식에 맞추어 확인해야 한다.

‘rollback’이라는 단어가 있다고 프로젝트 전체가 되돌릴 수 있다고 가정하지 말자. 이미 커밋한 작업, 데이터의 세부 내용을 없애는 변환, 외부 시스템에 보낸 메시지는 서로 다른 질문을 남긴다. 가상의 일정 분리에서 열 이름을 되돌려도 원래 문장이 어디에도 보존되지 않았다면 그 문장까지 복구되지는 않을 수 있다. 실행 전에 계획에서 이를 밝혀야 한다.

Aeneia 콘셉트 사진

SQLite의 ALTER TABLE 문서 (영어)는 자체적으로 지원하는 변경과 기존 구조, 인덱스, 뷰 및 기타 참조에 대한 의존성을 설명한다. 변경 방법은 모든 데이터베이스와 버전에서 같지 않다. 따라서 데이터베이스 명령 언어인 SQL에 대한 일반적인 지식에 기대지 말고 AI가 준비한 해결책을 실제 엔진과 설정에 맞추어 확인해야 한다.

각 단계에서 완료 조건과 거절 후 다음 경로를 정하자. 마이그레이션이 데이터를 바꾸기 전에 멈추는가? 알아볼 수 있는 부분 상태를 남기는가? 다시 실행하면 이미 끝낸 이전을 반복하는가? 답은 설계와 시험에서 나와야 한다. 보조 도구가 스크립트에 ‘안전하게 재시도 가능’이라는 주석을 추가하는 것만으로는 부족하다. 이전 실행을 어떻게 알아보는지 확인해야 한다.

끝나지 않은 작업의 롤백과 정상 업무가 일정 시간 이어진 뒤 돌아가는 것을 구분하자. 오래된 백업을 복원하면 백업 이후 새로 저장된 업무 건이 빠질 수 있다. 계획에는 그 기간을 어떻게 처리하고 복귀 허용 여부를 누가 결정하는지 적어야 한다. 사용자가 계속 데이터를 입력하는 동안 팀이 어느 쓰기를 보존해야 할지 모르는 장애 상황까지 결정을 미루지 말자.

중단과 복귀를 어떻게 시험할까?

격리된 자료로 시나리오를 만들자. 데이터베이스 책임자와 고른 통제된 중단 지점, 초기 상태, 기대하는 변경을 기록한다. 모호한 값의 이전을 거부하는 지점이 될 수 있다. 환경 전체를 무작위로 망가뜨리는 것이 목적이 아니다. 무엇이 바뀌었고 프로세스가 어떻게 계속되는지라는 구체적인 동작을 알아보는 것이 목적이다.

새 표현에 들어맞지 않는 자료도 고르자. 이 예에서 일정 문장에는 조건이 두 개이거나 다른 일이 일어나는 날짜가 들어 있을 수 있다. 그런 기록을 변경 없이 보존하고 확인 대상으로 표시할지, 합의한 단계를 막을지 정한다. 이는 스크립트 종료만이 아니라 데이터의 유용성에 대한 결정이다. 시험 기록이 모두 완벽하게 정리돼 있으면 업무 책임자가 걱정한 예외를 마이그레이션이 어떻게 처리하는지 알 수 없다.

먼저 올바른 실행을 검수한다. 선택한 업무 건, 관계의 동작, 시험 범위 안의 애플리케이션 읽기를 비교한다. 그다음 별도의 실패 시나리오와 예정된 복원을 수행한다. 두 실행은 서로 다른 질문에 답한다. 마이그레이션이 성공했다고 복귀 경로가 확인된 것은 아니며, 이전 상태 복원이 성공했다고 새 데이터 모델이 옳다는 뜻도 아니다.

실제 계획이 그 기간의 업무 지속을 허용한다면 참조 기간이 시작된 뒤 이루어진 쓰기도 시험에 추가하자. 그 쓰기를 어떻게 처리할지 기대 결과를 먼저 정한다. 아무것도 새로 입력하지 않은 데이터로 마이그레이션 직후 즉시 되돌리는 것보다 어려운 상황을 확인하게 된다. 이런 사례 하나만 살폈다면 모든 동시 작업 문제가 해결됐다고 덧붙이지 말자.

이전 쓰기 주체가 멈추는지도 확인하자. 오래된 애플리케이션 버전이나 대기 중인 작업이 여전히 이전 형식으로 쓸 수 있다면 새 구조에 합의된 경계가 필요하다. 해결책의 선택은 기술 설계에 속하지만 인수자는 기대한 동작의 증거를 보아야 한다. 화면을 새 버전으로 바꾸는 것만으로 이전에 시작된 작업이 어떻게 되는지는 설명되지 않는다.

오류를 포함해 실제 결과와 소요 시간을 기록하자. 권한이 없어 시험이 멈췄다면 마이그레이션 후 복원이 성공했다고 설명하지 말자. 중요한 장애물을 발견했을 수는 있지만 나머지 경로에 대한 질문은 여전히 남는다. 이 글은 수행된 데이터베이스 시험을 보고하지 않는다. 특정 해결책을 인수할 때 어떤 증거가 나와야 하는지 제시한다.

누가 변경 실행을 결정하는가?

승인자에게는 간결한 자료 묶음이 필요하다. 계획 버전, 확인된 초기 상태, 참조 백업, 두 경로의 결과, 남은 제한 목록이다. 중단해야 할 조건과 재개를 허용할 역할도 밝힌다. 시험의 인수와 운영 환경 실행 승인은 별개의 결정이다. AI는 첫 번째가 끝났다는 이유만으로 두 번째를 추론해서는 안 된다.

AI 행동에 대한 사람의 승인 (폴란드어) 원칙은 동의를 구체적인 작업과 범위에 연결하는 데 도움이 된다. 마이그레이션에서는 어느 데이터베이스, 버전, 시점에 대한 결정인지 명확해야 한다. 승인 후 연결 대상이나 스크립트가 바뀌면 검수 조건에 다시 비추어야 한다. 이전의 ‘예’에 자동으로 포함되지는 않는다.

쓰기 없이 계획된 변경의 미리보기를 준비했다면 그 결과를 별도의 증거로 보존하자. 특정 입력에 대한 의도를 보여주지만 마이그레이션이나 복원이 작동한다는 증거는 아니다. 스크립트 변경 후에는 시험의 해당 부분으로 돌아간다. 이렇게 해야 좋은 계획 검토가 빠진 실행을 대신하지 않는다.

후속 관리 계획에는 새 저장 형식의 첫 사용을 누가 확인할지, 이전 표현을 언제까지 유지할지를 적자. 첫 화면이 열렸다는 이유만으로 참조점을 제거하지 말자. 해당 프로세스에 맞는 확인 기간과 범위를 합의해야 한다. 동시에 백업을 보존한다고 데이터에 무제한 접근한다는 뜻은 아니다. 보관 규칙은 따로 정한다.

Aeneia Audit은 AI가 준비한 작업의 운영상 인수, 즉 경계와 책임, 시험, 증거의 품질을 정리하는 데 도움을 줄 수 있다. 데이터베이스 엔진 자체의 검토와 전문적인 마이그레이션 결정에는 적절한 역량과 합의된 범위가 필요하다.

Aeneia Audit

AI 에이전트의 도움으로 준비한 마이그레이션을 승인하기 전에 어떤 변경과 복원 증거가 필요한지 정해 보세요. 데이터베이스 변경의 인수 조건 상담하기

1차 출처는 2026년 10월 30일에 확인했다. 일정 예시는 가상이다. 설명한 마이그레이션을 실행하지 않았고, 운영 백업을 가져오거나 고객 시스템에서 작업하지 않았다.

Aeneia / Aeneia 편집부

편집부의 글입니다. 본문에 출처 링크가 있습니다.

Aeneia 소개

함께한 브랜드

  • L’Oréal
  • Garnier
  • Netflix
  • Carrefour
  • Warner Bros. Discovery
  • Biedronka
  • HBO Max
  • Wolt
  • Żabka
  • COSRX
  • 주폴란드 중국대사관
  • Mixa
Aeneia / Initium

지식에서 결정으로

정리하고 싶은 과제를 알려 주세요. 어디서 시작할지 함께 정합니다.

Aeneia에 문의하기

파트너의 솔루션을 활용합니다

  • Google
  • OpenAI
  • Microsoft
  • Stripe
  • Anthropic
  • Linear