일반적인 문제

Database Migration Service를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오.

마이그레이션 오류

Test Connection 및 마이그레이션이 실패하였습니다.

원인

• Source DB에 Database가 없습니다.
• Target DB에 Source DB와 동일한 Database 이름이 존재합니다.
• 마이그레이션에 필요한 권한이 설정되지 않았습니다.
• Source DB에 적용해야 하는 설정이 적용되지 않았습니다.
• MyISAM, BLACKHOLE, FEDERATED, ARCHIVE 엔진은 지원하지 않습니다.
• Source DB와 Target DB의 캐릭터셋이 다릅니다.
• 서비스 중인 클러스터를 Target DB로 지정했습니다.

해결 방법

• Source DB에 최소한 1개 이상의 Database가 있는지 확인해 주십시오.
• 중복된 Database는 삭제해 주십시오.
• Source DB가 GTID 모드인지 확인해 주십시오. 마이그레이션에 필요한 권한 항목은 마이그레이션을 위해 필요한 최소 권한 항목을 참조해 주십시오.
• Source DB에 다음과 같은 설정이 적용되었는지 확인해 주십시오.
  • 바이너리 로그를 활성화하며 server_id 값을 지정해 주십시오.
  • log_bin의 값이 ON으로 표시되는지 확인해 주십시오
  • Source DB 복제에 필요한 사전 준비에 대한 설명은 사전 준비를 참조해 주십시오.
• 지원하지 않는 MySQL 엔진을 선택한 것은 아닌지 확인해 주십시오. Source DB의 상세 설정에 따른 지원 여부는 지원 데이터베이스를 참조해 주십시오.
• 마이그레이션 시 지원하는 캐릭터셋은 utf8, utf8mb4, euckr입니다. 캐릭터셋이 다를 경우, Source DB의 DB 및 Table 캐릭터셋을 변경한 후 마이그레이션을 진행해 주십시오.
• 마이그레이션 진행 시 Target DB는 다시 시작되며 데이터 읽기만 가능합니다. 서비스 중인 클러스터는 Target DB로 지정하지 않도록 주의해 주십시오.

마이그레이션 미완료

마이그레이션 실행 단계가 Replication까지 모두 완료됐으나 Cloud DB for MySQL 콘솔에서는 '마이그레이션' 상태로 표시됩니다.

원인

Migration Completed (Replication 완료) 단계인 경우 콘솔에서 [완료] 버튼을 클릭해야 최종적으로 DB 서비스 이전이 가능합니다.

해결 방법

'Migration Completed' 상태인지 확인한 후, [완료] 버튼을 클릭해 주십시오.

MariaDB 마이그레이션

MariaDB 마이그레이션 시 호환성 관련 오류 메시지가 나타납니다.

원인

Source DB가 MariaDB인 경우도 마이그레이션이 가능합니다. 단, 지원이 종료된(EOL) MariaDB 버전은 마이그레이션 과정에서 호환성 관련 오류 메시지가 발생할 수 있습니다.

해결 방법

동일한 오류가 계속 발생하는 경우, Target DB를 MySQL 5.7 버전으로 변경해 마이그레이션을 진행하거나 Source DB의 버전을 변경해 주십시오.

Source DB에 설정된 Definer 계정 마이그레이션 오류

마이그레이션할 때 Source DB에 설정된 Definer 계정이 생성되지 않았습니다.

원인

사용자 계정은 마이그레이션 대상에 포함되지 않습니다.

해결 방법

Definer에 사용된 계정을 Target DB에서 직접 생성해 주십시오. 자세한 내용은 DB User 관리를 참조해 주십시오.

DB Config 설정이 마이그레이션되지 않음

DB Config 설정이 마이그레이션되지 않았습니다.

원인

DB Config 설정에 대한 마이그레이션은 지원하지 않습니다.

해결 방법

사전에 Character Set/Collation 등 Target DB 상에서 Source DB와 동일하게 설정해 주십시오.

Test Connection 지연

Test Connection 소요 시간이 오래 걸립니다.

원인

Source DB의 스키마 개수가 많으면 수분 가량의 시간이 소요될 수 있습니다. 이는 마이그레이션 정상 진행을 위한 권한 체크, 스키마 점검 등의 과정입니다.

해결 방법

오류 상황이 아니므로 별도로 조치할 사항이 없습니다. 새로 고침 시 점검이 초기화되므로 새로고침하지 않도록 주의해 주십시오.

"Killed $RESTORECMD" 오류 메시지

Backup 타입: mydumper 사용 시 'Killed $RESTORECMD' 오류 창이 나타납니다.

원인

마이그레이션 대상 테이블의 크기가 클 경우, Thread 제한 개수를 높게 설정할수록 Importing 진행 시 메모리 사용률이 증가하여 OOM Kill 발생 확률이 증가합니다.

해결 방법

마이그레이션을 삭제한 후, Thread 제한값을 낮춰 재시도해 주십시오.

권한 오류

• GRANT REPLICATION SLAVE ON *.* TO '사용자명'@'%'; 실행 시 오류가 발생합니다. 또한 [28000][1045] Access denied for user '계정명'@'허용호스트' 메시지가 나타납니다.
• Replication 단계에서 Master command COM_REGISTER_SLAVE failed: Access denied for user '계정명'@'허용호스트' (using password: YES) (Errno: 1045) 오류 메시지가 나타납니다.

원인

• 접속한 계정의 권한에 문제가 있을 경우, 오류가 발생할 수 있습니다.
• 계정에 Replication을 위한 권한이 존재하지 않을 경우, 오류가 발생할 수 있습니다.

해결 방법

접속한 계정의 권한을 확인해 주십시오. 해당 명령어를 실행하려면 작업을 수행하는 계정이 GRANT REPLICATION SLAVE*.* TO '계정명'@'허용호스트' WITH GRANT OPTION ; 권한을 보유하고 있어야 합니다. 해당 권한은 DDL 권한으로, 콘솔에서 생성된 계정에 한해서만 부여하고 있습니다.

REPLICATION 권한 부여

1. Source DB 상에서 다음 명령어를 입력하여 REPLICATION SLAVE 권한 여부를 확인해주십시오.

   show grants for '계정명'@'허용호스트';`
   

2. Source DB 의 계정에 REPLICATION SLAVE 권한을 부여해 주십시오.

   GRANT REPLICATION SLAVE ON *.* TO '계정명'@'허용호스트';`