Documentation Index

Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

Migration Management

Prev Next

VPC 환경에서 이용 가능합니다.

Migration Management에서는 Migration 작업을 생성하여 마이그레이션에 필요한 단계별 작업을 자동화할 수 있습니다. 또한 Migration 작업의 상태를 확인하고 필요에 따라 작업을 재시작, 중지, 완료, 삭제할 수 있습니다.
데이터베이스의 마이그레이션은 백업, 복구, 데이터 동기화 단계로 진행됩니다.

  • 백업(Export): Source DB에서 데이터 백업
  • 복구(Import): Target DB에 데이터 복구
  • 데이터 동기화(Replication): Source DB와 Target DB의 데이터 동기화
참고
  • 복구가 완료되면 백업 파일은 삭제됩니다.
  • MySQL DB의 데이터 복구 시 바이너리 로그 사이즈 증가를 예방하기 위해 Target DB의 바이너리 로그는 1일만 보관되고, 복구가 완료되면 기본 설정이 적용됩니다.
  • DB User 계정은 마이그레이션 되지 않습니다. 직접 Target DB에서 생성해 주십시오. (DB User 관리 참고)
  • Migration 작업은 Test Connection 시점 기준으로 존재하는 Database 리스트에 한해서 진행됩니다. Test Connection 이후 Migration 진행 중 추가로 생성되는 Database에 대해서는 정합성이 보장되지 않습니다.
  • Migration Completed(= Replication 완료) 단계는 초기 데이터 이전 후에도 원본 DB의 변경 사항이 목적지 DB에 계속 동기화되는 상태를 의미합니다.
    이 실시간 동기화는 사용자가 콘솔에서 [완료] 버튼을 클릭하여 이전을 최종적으로 마칠 때까지 유지됩니다.

마이그레이션 준비

Migration 작업을 생성하고 마이그레이션을 진행하기 전에 다음 사항을 완료해 주십시오.

  • Source DB 및 Target DB 접속 설정(Source DB 및 Target DB 접속 설정 참고)
  • Source DB Endpoint 생성(Endpoint 생성 참고)
  • Target DB가 운영 중인 상태인지 확인
  • Source DB에서 사용 중인 프로시저 Definer 계정이 있는 경우, Target DB에 ID와 접속 Host가 동일한 계정 생성(DB User 관리 참고)
  • Source DB의 Config를 변경한 경우, Target DB에 해당 변경 사항 적용(DB Config 관리 참고)
  • Target DB에 Source DB와 동일한 데이터베이스가 존재하는 경우, Target DB의 데이터베이스 삭제
주의

Target DB에 Source DB와 동일한 데이터베이스가 존재하는 경우 마이그레이션을 수행하지 않습니다. Target DB의 동일한 데이터베이스 이름을 삭제한 뒤 진행해주시기 바랍니다.

Migration 작업 생성

Migration 작업을 생성하여 손쉽게 Source DB의 데이터를 Target DB로 마이그레이션할 수 있습니다.

참고
  • Migration 작업을 생성하기 전에 마이그레이션 준비를 완료해 주십시오.
  • Migration 작업 생성 후 바로 마이그레이션이 시작됩니다.
  • Migration 작업이 완료 또는 삭제될 때까지 Target DB의 콘솔 조작, 데이터 수정 및 입력은 불가능합니다. (데이터 읽기는 가능)
  • Migration 의 Source DB에는 영향 없이 마이그레이션 진행이 가능합니다.
  • Target DB 에 대한 Importing 이 진행되는 동안 Target DB 상에서의 별도 백업 수행이 제한됩니다.

Migration 작업을 생성하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 Menu > Services > Database > Database Migration Service 메뉴를 차례대로 클릭해 주십시오.
  2. Migration Management 메뉴를 클릭해 주십시오.
  3. [Migration 작업생성] 버튼을 클릭해 주십시오.
  4. 다음 정보를 입력해 주십시오.
    • Migration 작업 이름: 원하는 이름 입력
    • Source DB: Source DB Endpoint의 Source DB 식별자 선택
      • [Endpoint 수정]: 클릭하여 Endpoint에 설정한 Source DB 접속 정보 수정(접속 정보에 대한 자세한 내용은 Endpoint 생성 참고)
    • Endpoint URL, DB PORT, DB User: Source DB 선택 시 Endpoint에 설정한 Source DB 정보 표시
    • Target DB: 네이버 클라우드 플랫폼에 생성한 Target DB 선택
  5. [Test Connection] 버튼을 클릭하여 Source DB와 Target DB의 연결을 테스트해 주십시오.
    • 테스트 성공 시 DB엔진 버전, GTID MODE 정보 자동 입력
    • 오류 발생 시 알림 팝업 창 표시
  6. 다음 정보를 입력해 주십시오.
    • Backup 타입: mysqldump / mydumper 중 선택
    • Thread 제한:
      • Backup 타입이 mysqldump 일 경우, 고정값 1
      • Backup 타입이 mydumper 일 경우, 2부터 10까지 숫자 중 사용자 입력
        (단, 입력 가능한 Thread 수는 Target DB 서버의 CPU 및 Memory 사양에 따라 상한선이 제한됩니다.)
    • 대상 데이터베이스: 마이그레이션 대상 데이터베이스 1개 이상 선택
  7. [Migration 작업시작] 버튼을 클릭해 주십시오.
    • 연결 테스트가 완료된 후 버튼이 활성화됩니다.
  8. 알림 팝업 창이 나타나면 [확인] 버튼을 클릭해 주십시오.
    • 마이그레이션이 시작됩니다.
주의
  • mydumper 선택시 Thread 제한 값이 커질 수록 마이그레이션 속도는 빨라지나 Source DB 및 Target DB 에 가중되는 부하가 커집니다. 따라서 이점 유의하여 Thread 제한 값을 지정해 주시기 바랍니다.
  • mydumper 를 활용하기 위해서는 최소 vCPU 2개, 메모리 8GB 이상의 스펙 Target DB 를 생성 후 진행하는 것을 권장 드립니다.

Migration 작업 정보 확인

생성한 Migration 작업의 정보를 확인하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 Menu > Services > Database > Database Migration Service 메뉴를 차례대로 클릭해 주십시오.
  2. Migration Management 메뉴를 클릭해 주십시오.
  3. 작업 목록에서 기본 정보를 확인하거나 원하는 작업을 클릭하여 작업 정보를 확인해 주십시오.
    • 기본 정보
      • 작업 상태: 작업의 현재 상태
        • 진행중: 마이그레이션이 진행 중인 상태
        • 비정상 종료: 오류 발생으로 마이그레이션이 비정상 종료된 상태
        • 중지: 사용자가 마이그레이션을 강제 중지한 상태
        • 완료: Source DB와의 연결을 완전히 끊은 상태로 재시작 및 이전 상태로 돌아가기 불가
      • 실행 단계: 현재 실행 중인 작업 단계 표시. 작업 상태진행중인 경우에만 표시.
        • Exporting: Source DB의 데이터 백업 중
        • Importing: Target DB로 데이터 복구 중
        • Replication: Source DB와 Target DB의 데이터 동기화 중
      • Source DB: 사용자가 설정한 Source DB 식별자
      • Target DB: 사용자가 설정한 Target DB 이름
      • 시작 일시: 마이그레이션을 시작한 시간
      • 종료 일시: 마이그레이션이 완료된 경우 종료 일시 표시
      • 경과 시간: 마이그레이션이 완료된 경우 마이그레이션에 걸린 시간, 진행 중인 경우 최초 마이그레이션을 시작한 시간부터 현재까지 경과된 시간 표시
      • Migration 용량: Source DB의 백업 파일 크기
    • 작업 정보
      • Source DB 엔진 버전: Source DB의 DBMS 유형과 버전
      • Target DB 엔진 버전: Target DB의 DBMS 유형과 버전
      • Migration 시작 일시: 마이그레이션을 시작한 시간
      • Migration 종료 일시: 마이그레이션이 완료된 경우 종료 일시 표시
      • Migration Status: 작업의 현재 상태
      • Target DB Server 이름: Target DB 서버의 이름
      • 실행 단계: 작업 상태진행중인 경우 각 실행 단계의 상태(작업 전, 진행 중, 완료, Error) 표시
        • Exporting: Source DB의 데이터 백업 진행 상태
        • Importing: Target DB로 데이터 복구 진행 상태
        • Replication: Source DB와 Target DB의 데이터 동기화 진행 상태
        • 진행 상태가 Error인 경우, [에러보기] 를 클릭하여 오류 내용 확인
      • Backup 타입: 마이그레이션 시 사용된 백업 도구 유형 (mysqldump 또는 mydumper)
      • Thread 개수: 백업 및 복구 시 사용된 Thread 수

각 실행 단계(Exporting, Importing, Replication)에서 오류가 발생하면 진행 상태가 Error로 표시되며, [에러보기] 를 클릭하여 상세 오류 내용을 확인할 수 있습니다.

  • Exporting 단계 오류: Source DB 접속 정보, 권한 등을 확인하고 원인을 조치한 후 마이그레이션을 재시작해 주십시오.
  • Importing 단계 오류: Target DB 상태 및 디스크 용량 등을 확인하여 원인을 조치한 후 마이그레이션을 재시작해 주십시오. 오류 원인에 따라 마이그레이션을 삭제한 후 다시 생성하여 진행해야 할 수 있습니다.
  • Replication 단계 오류: 오류 내용을 확인한 뒤 [복제 오류 스킵] 버튼을 클릭하여 해당 오류를 건너뛸 수 있습니다.

복제 오류 스킵
Replication 단계에서 복제 오류가 발생한 경우, [복제 오류 스킵] 버튼을 클릭하면 오류가 발생한 트랜잭션을 건너뛰고 데이터 동기화를 계속 진행할 수 있습니다.

  • 스킵이 완료되면 Replication이 자동으로 재개되며 실행 단계가 진행 중 상태로 전환됩니다.
  • 복제 오류 스킵은 Replication 단계에서만 사용할 수 있으며, Exporting 또는 Importing 단계의 오류에는 적용되지 않습니다.
참고
  • 백업 및 복구 중 오류가 발생한 경우 오류 내용 조치 후 마이그레이션을 다시 시도해 주십시오.
  • Replication 단계에서 실패한 경우 Target DB 에 대한 백업 수행이 제한됩니다.
  • Replication까지 모두 완료된 상태라면 [완료] 버튼을 클릭하여 Target DB 가 서비스 가능한 상태가 되도록 해주십시오.
주의
  • 복제 오류 스킵은 GTID 기반의 복제 환경에서 현재 오류가 발생한 트랜잭션을 건너뛰는 방식으로 동작합니다. 스킵된 트랜잭션의 데이터는 Target DB에 반영되지 않으므로, 스킵 이후 Source DB와 Target DB 간 데이터 정합성을 반드시 확인해 주십시오.
  • 복제 오류가 반복적으로 발생하는 경우, Source DB의 원인을 조치한 후 마이그레이션을 삭제하고 재생성하는 것을 권장합니다.

테이블 현황 점검

Replication 단계가 완료되면 Source DB와 Target DB 간 테이블 누락 및 데이터 미복원 여부를 자동으로 점검합니다. 점검 결과는 작업 정보 화면의 테이블 현황 점검 영역에서 확인할 수 있습니다.

테이블 현황 점검 항목에 대한 설명은 다음과 같습니다.

  • 상태: 점검 결과 상태
    • 이상 없음: Source DB와 Target DB 간 통계 기반 확인에서 차이가 발견되지 않은 상태
    • 이상 탐지: 일부 테이블에서 누락 또는 데이터 미복원이 감지된 상태
  • 점검 일시: 점검이 완료된 시각 및 소요 시간
  • 점검 결과: 통계 기반 확인 결과 요약
    • 상태가 이상 없음인 경우: Source ↔ Target 간 N개 테이블 통계 기반 확인 완료 형태로 표시
    • 상태가 이상 탐지인 경우: 이상 없음 N / 이상 탐지 N 형태로 표시되며, 하단에 상세 내용 표를 함께 제공
      • DB명: 이상이 탐지된 DB 이름
      • 테이블명: 이상이 탐지된 테이블 이름
      • 탐지 내용: 탐지된 사유 (예: Target DB에 테이블이 존재하지 않음)

테이블 현황 점검은 Replication 단계가 완료되는 시점에 자동으로 1회 수행됩니다. Replication 단계에서 [중지][재시작] 하여 다시 Replication이 완료되는 경우에도 자동으로 재점검됩니다.

참고
  • 본 점검은 DB 통계를 기반으로 테이블 누락 및 데이터 미복원 여부를 확인합니다. row 수준의 정밀 비교는 점검에 포함되지 않습니다.
  • 이상 탐지 항목은 최대 10건까지 표시됩니다.
  • 점검 결과는 [완료] 버튼 사용 가능 여부에 영향을 주지 않습니다. 이상이 탐지되어도 [완료] 버튼을 클릭할 수 있으며, 이 경우 Source DB와 Target DB 간 데이터 정합성을 직접 확인해 주십시오. 특이사항이 있을 경우 고객 센터로 문의해 주십시오.

Migration 작업 재시작

비정상 종료되었거나 중지한 Migration 작업을 재시작하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 Menu > Services > Database > Database Migration Service 메뉴를 차례대로 클릭해 주십시오.
  2. Migration Management 메뉴를 클릭해 주십시오.
  3. 작업 목록에서 재시작할 작업을 클릭하고 [재시작] 버튼을 클릭해 주십시오.
  4. 알림 팝업 창이 나타나면 [확인] 버튼을 클릭해 주십시오.
    • 작업 상태진행중으로 변경됩니다.
참고
  • 비정상 종료 확인 및 원인 조치 이후 마이그레이션 재시작 진행 시 동일 에러 메시지가 출력된다면 마이그레이션 삭제 이후 재생성 진행해 주시기 바랍니다.

Migration 작업 중지

진행 중인 Migration 작업을 중지하는 방법은 다음과 같습니다.

참고
  • 백업 중이거나, 복구 중인 경우 해당 작업이 취소됩니다.
  • 중지한 이후에도 재시작할 수 있습니다. (Migration 작업 재시작 참고)
    • 백업 중 중지된 경우: 재시작 시 Source DB의 데이터 백업을 처음부터 다시 진행합니다.
    • 복구 중 중지된 경우: 재시작 시 Target DB의 데이터 복구를 처음부터 다시 진행합니다.
  1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 Menu > Services > Database > Database Migration Service 메뉴를 차례대로 클릭해 주십시오.
  2. Migration Management 메뉴를 클릭해 주십시오.
  3. 작업 목록에서 중지할 작업을 클릭하고 [중지] 버튼을 클릭해 주십시오.
  4. 알림 팝업 창이 나타나면 [확인] 버튼을 클릭해 주십시오.
    • 작업 상태중지로 변경됩니다.

Migration 작업 완료

Source DB와의 데이터 동기화 작업을 종료하고, Target DB를 조작할 수 있는 상태로 변경합니다.

  • Migration 작업의 작업 상태진행중, 실행 단계Replication 완료인 경우에만 가능합니다.
참고
  • Migration 작업 완료에 수 분이 소요될 수 있습니다.
  • 완료 이후에 마이그레이션이 필요한 경우 Migration 작업 생성부터 다시 시작해야 합니다.

Migration 작업을 완료하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 Menu > Services > Database > Database Migration Service 메뉴를 차례대로 클릭해 주십시오.
  2. Migration Management 메뉴를 클릭해 주십시오.
  3. 작업 목록에서 종료할 작업을 클릭하고 [완료] 버튼을 클릭해 주십시오.
  4. 알림 팝업 창이 나타나면 [확인] 버튼을 클릭해 주십시오.

Migration 작업 삭제

Migration 작업 정보를 삭제할 수 있습니다. 단, Migration 작업의 작업 상태가 비정상 종료, 정지, 또는 완료인 경우에만 삭제가 가능합니다.

주의
  • 삭제 이후에는 Migration 작업 정보를 복구할 수 없습니다.
  • Migration 작업 정보에 입력한 Source DB 정보는 Endpoint Management 메뉴에서 확인할 수 있습니다.

Migration 작업 정보를 삭제하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 Menu > Services > Database > Database Migration Service 메뉴를 차례대로 클릭해 주십시오.
  2. Migration Management 메뉴를 클릭해 주십시오.
  3. 작업 목록에서 정보를 삭제할 작업을 클릭하고 [삭제] 버튼을 클릭해 주십시오.
  4. 알림 팝업 창이 나타나면 [확인] 버튼을 클릭해 주십시오.