MySQL 문제 진단

오류 문제 해결하기

런타임 중에 이전 작업 프로세스에 오류가 발생할 수 있습니다.

• 소스 데이터베이스의 잘못된 비밀번호와 같은 일부 오류는 복구할 수 있으므로 수정할 수 있으며 마이그레이션 작업이 자동으로 재개됩니다.
• 바이너리 로그 위치 손실과 같이 복구할 수 없는 오류도 있습니다. 이 경우 마이그레이션 작업을 처음부터 다시 시작해야 합니다.

오류가 발생하면 이전 작업 상태가 Failed로 변경되고 하위 상태는 실패 전의 마지막 상태를 반영합니다.

오류를 해결하려면 실패한 이전 작업으로 이동하여 오류를 확인하고 오류 메시지에 설명된 단계를 따릅니다.

오류에 관한 자세한 내용을 보려면 이전 작업의 링크를 사용하여 Cloud Monitoring으로 이동하세요. 로그가 특정 이전 작업으로 필터링됩니다.

다음 표에서 문제의 예와 해결 방법을 확인할 수 있습니다.

오류 1108: 행 크기가 너무 큼

해결 방법

기존 대상 인스턴스에서 추가 데이터 삭제

기존 대상 인스턴스로 이전하면 다음과 같은 오류 메시지가 표시됩니다. The destination instance contains existing data or user defined entities (for example databases, tables, or functions). You can only migrate to empty instances. Clear your destination instance and retry the migration job.

이 문제는 대상 인스턴스에 추가 데이터가 포함되어 있을 때 발생할 수 있습니다. 비어 있는 기존 인스턴스로만 이전할 수 있습니다. 알려진 제한사항을 참고하세요.

해결 방법

다음 단계를 수행하여 대상 인스턴스에서 추가 데이터를 삭제하고 마이그레이션 작업을 다시 시작합니다.

1. 마이그레이션 작업을 중지합니다.
2. 이 시점에서 대상 Cloud SQL 인스턴스는 read-only 모드입니다. 대상 인스턴스를 승격하여 쓰기 액세스 권한을 얻습니다.
3. 대상 Cloud SQL 인스턴스에 연결합니다.
4. 대상 인스턴스 데이터베이스에서 추가 데이터를 삭제합니다. 대상에는 시스템 구성 데이터만 포함할 수 있습니다. 대상 데이터베이스에는 사용자 데이터 (예: 테이블)가 포함될 수 없습니다. 데이터베이스에서 실행하여 시스템 외 데이터를 찾을 수 있는 다양한 SQL 문이 있습니다. 예를 들면 다음과 같습니다.

   SELECT schema_name FROM information_schema.SCHEMATA
   WHERE schema_name NOT IN ('information_schema', 'sys', 'performance_schema', 'mysql');
     

5. 마이그레이션 작업을 시작합니다.

Terraform 구성 변경

해결 방법

• 백업 구성이 기본값으로 설정됩니다.
• PITR(포인트 인 타임 리커버리)이 기본값으로 재설정됩니다.

오류 1109 (42S02): <여기에 스키마 이름>에 알 수 없는 테이블이 있습니다.

마이그레이션 작업이 다음 메시지(예: ERROR 1109 (42S02) at line X: Unknown table 'GLOBAL_STATUS' in information_schema)와 함께 실패합니다.ERROR 1109 (42S02): Unknown table in <schema name here>

문제 원인

Database Migration Service는 mysql, performance_schema, information_schema, ndbinfo 또는 sys 시스템 스키마를 이전하지 않습니다( 알려진 제한사항 참고). 소스 데이터베이스에 이러한 스키마의 테이블을 참조하는 객체가 포함되어 있으면 마이그레이션 작업이 실패할 수 있습니다.

해결 방법

# Query to check routines or functions definitions.
SELECT ROUTINE_SCHEMA, ROUTINE_NAME FROM information_schema.routines
WHERE ROUTINE_SCHEMA NOT IN ('information_schema', 'mysql', 'ndbinfo', 'performance_schema', 'sys')
AND ROUTINE_DEFINITION like '%OBJECT_NAME_REPORTED_IN_THE_ERROR_MESSAGE%'

# Query to check view definitions.
SELECT TABLE_SCHEMA, TABLE_NAME FROM information_schema.views
WHERE TABLE_SCHEMA NOT IN ('information_schema', 'mysql', 'ndbinfo', 'performance_schema', 'sys')
AND view_definition like '%OBJECT_NAME_REPORTED_IN_THE_ERROR_MESSAGE%'

# Query to check trigger definitions.
SELECT TRIGGER_SCHEMA, TRIGGER_NAME FROM information_schema.TRIGGERS
WHERE TRIGGER_SCHEMA NOT IN ('information_schema', 'mysql', 'ndbinfo', 'performance_schema', 'sys')
AND event_object_table = 'OBJECT_NAME_REPORTED_IN_THE_ERROR_MESSAGE'

# Query to check constraint definitions.
SELECT TABLE_SCHEMA, TABLE_NAME
FROM information_schema.KEY_COLUMN_USAGE
WHERE TABLE_SCHEMA NOT IN ('information_schema', 'mysql', 'ndbinfo', 'performance_schema', 'sys')
AND REFERENCED_TABLE_NAME = 'OBJECT_NAME_REPORTED_IN_THE_ERROR_MESSAGE'

information_schema에 알 수 없는 테이블 'COLUMN_STATISTICS'

mysqldump 유틸리티 버전 8 이상을 실행하여 8 미만의 MySQL 데이터베이스 버전을 내보내면 Unknown table 'COLUMN_STATISTICS' in information_schema (1109) 오류가 발생합니다.

문제 원인

8 미만 버전의 MySQL 데이터베이스에는 COLUMN_STATISTICS 테이블이 없습니다. 버전 8 이상에서는 mysqldump 유틸리티가 기본적으로 이 표를 내보내려고 시도합니다. 열이 없으므로 내보내기가 실패합니다.

해결 방법

mysqldump 명령어에 --column-statistics=0 플래그를 추가하여 내보내기에서 COLUMN_STATISTICS 테이블을 삭제합니다. 자세한 내용은 mysqldump를 사용하여 MySQL 데이터베이스 내보내기를 참고하세요.

지정된 키가 너무 깁니다. 최대 키 길이는 767바이트입니다.

Specified key was too long; max key length is 767 bytes. 오류가 표시됩니다.

문제 원인

소스 데이터베이스에 innodb_large_prefix 변수가 설정되어 있을 수 있습니다. 이렇게 하면 767바이트보다 긴 색인 키 접두사가 허용됩니다. MySQL 5.6의 기본값은 OFF입니다.

해결 방법

대상 데이터베이스를 만들 때 innodb_large_prefix 플래그를 ON로 설정하거나 기존 대상 데이터베이스를 플래그로 업데이트합니다.

테이블 정의가 변경됨

Table definition has changed 오류가 표시됩니다.

문제 원인

덤프 프로세스 중에 DDL이 변경되었습니다.

해결 방법

덤프 프로세스 중에 테이블을 수정하거나 다른 DDL 변경을 수행하지 마세요.스크립트를 사용하여 DDL 작업이 중지되었는지 확인할 수 있습니다.

액세스 거부됨. 이 작업에 대한 SUPER 권한(하나 이상)이 필요합니다.

Access denied; you need (at least one of) the SUPER privilege(s) for this operation 오류가 표시됩니다.

문제 원인

소스 데이터베이스에 super user@localhost (예: root@localhost)를 사용하는 이벤트, 뷰, 함수, 프로시저가 있을 수 있습니다. 이는 Cloud SQL에서는 지원되지 않습니다.

해결 방법

DEFINER 절이 있는 데이터베이스 마이그레이션에 대한 자세한 내용은 이 문서를 참고하세요.

오류 메시지: Definer user 'x' does not exist. Please create the user on the replica.

Definer user 'x' does not exist. Please create the user on the replica. 오류가 표시됩니다.

문제 원인

근본 원인은 DEFINER 절이 있는 소스 데이터베이스의 사용자가 복제본 데이터베이스에 존재하지 않기 때문입니다.

해결 방법

DEFINER 절이 있는 데이터베이스 마이그레이션에 대한 자세한 내용은 이 문서를 참고하세요. 복제본 데이터베이스에 사용자를 만들어야 할 수도 있습니다.

오류 메시지: ERROR 1045 (28000) at line {line_number}: Access denied for user 'cloudsqlimport'@'localhost

ERROR 1045 (28000) at line {line_number}: Access denied for user 'cloudsqlimport'@'localhost 오류가 표시됩니다.

문제 원인

근본 원인은 DEFINER 절이 있는 소스 데이터베이스의 사용자가 복제본 데이터베이스에 존재하지 않는데 해당 사용자가 소스 데이터베이스의 객체 정의에서 상호 참조된다는 점입니다.

해결 방법

DEFINER 절이 있는 데이터베이스 마이그레이션에 대한 자세한 내용은 이 문서를 참고하세요. 복제본 데이터베이스에 하나 이상의 사용자를 만들어야 할 수 있습니다.

테이블을 덤프할 때 쿼리 중에 MySQL 서버와의 연결이 끊어졌습니다.

Lost connection to MySQL server during query when dumping table 오류가 표시됩니다.

문제 원인

• 대상 인스턴스에서 소스 데이터베이스 인스턴스에 연결할 수 없게 되었을 수 있습니다.
• 소스 데이터베이스에는 소스 데이터베이스에서 max_allowed_packet을 더 큰 수로 설정해야 하는 큰 blob 또는 긴 문자열이 있는 테이블이 있을 수 있습니다.

해결 방법

• 소스 데이터베이스 인스턴스가 작동 중이고 연결 가능한지 확인합니다.
• 마이그레이션 작업에서 max-allowed-packet 플래그를 구성한 후 마이그레이션 작업을 다시 시작합니다. 또는 max_allowed_packet 옵션으로 수동 덤프 를 생성하여 데이터를 덤프하고 덤프 파일로 마이그레이션합니다.
• max_allowed_packet를 늘리려면 소스 데이터베이스의 net_read_timeout 및 net_write_timeout 설정을 조정해야 할 가능성이 큽니다 (일반적으로 연결 오류가 중지될 때까지 늘려야 함).

테이블을 덤프할 때 'max_allowed_packets' 바이트보다 큰 패킷이 있습니다.

Got packet bigger than 'max_allowed_packet' bytes when dumping table 오류가 표시됩니다.

문제 원인

패킷이 설정에서 허용하는 것보다 큽니다.

해결 방법

max_allowed_packet 옵션과 함께 수동 덤프를 사용하여 마이그레이션 작업을 만들고 데이터를 덤프한 후 덤프 파일로 마이그레이션합니다.

복제되는 데이터가 없음

초기 데이터 마이그레이션이 성공했지만 복제 중인 데이터가 없습니다.

문제 원인

한 가지 가능한 근본 원인은 소스 데이터베이스에서 복제 플래그를 정의하여 일부 또는 전체 데이터베이스 변경사항이 복제되지 않기 때문일 수 있습니다.

해결 방법

binlog-do-db, binlog-ignore-db, replicate-do-db, replicate-ignore-db와 같은 복제 플래그가 충돌 방식으로 설정되어 있지 않은지 확인합니다.
소스 데이터베이스에서 show master status 명령어를 실행하여 현재 설정을 확인합니다.

초기 데이터 마이그레이션에 성공했지만 얼마 후 데이터 복제가 더 이상 작동하지 않습니다.

초기 데이터 마이그레이션에 성공했지만 얼마 후 데이터 복제가 더 이상 작동하지 않습니다.

문제 원인

이 문제의 근본 원인은 여러 가지가 있을 수 있습니다.

해결 방법

• Cloud Monitoring UI에서 대상 인스턴스의 복제 측정항목을 확인합니다.
• MySQL IO 스레드 또는 SQL 스레드의 오류는 mysql.err 로그 파일의 Cloud Logging에서 확인할 수 있습니다.
• 이 오류는 대상 인스턴스에 연결할 때도 찾을 수 있습니다. SHOW REPLICA STATUS 명령어를 실행하고 출력에서 다음 필드를 확인합니다.
  • Replica_IO_Running
  • Replica_SQL_Running
  • Last_IO_Error
  • Last_SQL_Error

  참고: SHOW REPLICA STATUS는 MySQL 8.0.22에서 도입된 별칭입니다. 이전 버전 (MySQL 5.7, MySQL 8.0)의 경우 status 명령어의 이전 별칭을 사용합니다. 자세한 내용은 MySQL 문서의 상태 문을 참고하세요.

  fatal error 1236 from master when reading data from binary log: 'Could not find first log file name in binary log index file' in Last_IO_Error 오류가 발생한 경우 소스 인스턴스의 바이너리 로그 보관 설정이 충분하지 않기 때문일 수 있습니다.

  error connecting to master 'USER_NAME@SOURCE_HOST:SOURCE_PORT' - retry-time: RETRY_TIME retries: RETRIES 오류가 발생한 경우 연결 또는 인증 문제로 인해 대상 인스턴스가 소스에 다시 연결되지 않았기 때문일 수 있습니다.

mysqld 확인 실패: 데이터 디스크가 가득 찼습니다.

mysqld check failed: data disk is full 오류가 표시됩니다.

문제 원인

대상 인스턴스의 데이터 디스크가 가득 찬 것일 수 있습니다.

해결 방법

대상 인스턴스의 디스크 크기를 늘립니다.

소스 데이터베이스 연결 실패

소스 데이터베이스 연결 실패

문제 원인

소스 데이터베이스 인스턴스와 대상 인스턴스 간에 연결 문제가 있습니다.

해결 방법

연결 디버깅 도움말의 단계를 따르세요.

관리형 데이터베이스 (Amazon RDS/Aurora)에서 마이그레이션이 시작되지 않음

이전 작업이 시작되지 않습니다.

문제 원인

SUPERUSER 권한이 없는 관리형 소스 데이터베이스에서 마이그레이션하려면 마이그레이션 시작 시 잠시 다운타임이 필요합니다.

해결 방법

• Amazon RDS의 경우 이 도움말의 단계를 따르세요.
• Amazon Aurora의 경우 이 도움말의 단계를 따르세요.

바이너리 로그가 소스 데이터베이스에서 잘못 구성됨

바이너리 로그에 문제가 있음을 나타내는 오류가 표시됩니다.

문제 원인

소스 데이터베이스에서 바이너리 로그 구성이 잘못된 경우 지속적인 MySQL 마이그레이션 작업에서 이러한 오류가 발생할 수 있습니다.

해결 방법

여기에 나온 정의를 따르세요.

제공된 덤프 파일을 읽을 수 없음

덤프 파일에 문제가 있음을 나타내는 오류가 표시됩니다.

문제 원인

DMS에서 제공된 덤프 파일을 찾을 수 없습니다.

해결 방법

1. 덤프 경로를 확인하여 올바른 파일이 있는지 확인하거나 경로를 변경합니다.
2. 경로를 변경하는 경우 PATCH 요청을 사용하여 작업에서 경로를 사용하도록 합니다.
3. 이전 작업을 다시 시작합니다.

바이너리 로그 위치가 손실되어 복제를 재개할 수 없음

바이너리 로그 위치가 손실되었습니다.

문제 원인

이 오류는 복제 프로세스가 장시간 일시중지되어 바이너리 로그 위치가 손실될 때 발생할 수 있습니다. 바이너리 로그 보관 기간에 근접한 기간 동안 마이그레이션 작업을 일시중지하면 안 됩니다.

해결 방법

이전 작업을 다시 시작합니다.

소스 및 대상 데이터베이스 버전이 호환되지 않아 마이그레이션 작업을 실행할 수 없음

소스 및 대상 데이터베이스 버전이 지원되지 않는 조합입니다.

문제 원인

제공된 소스 데이터베이스 버전이 대상 데이터베이스 버전과 호환되지 않습니다.

해결 방법

대상 데이터베이스 버전이 소스 대상 버전과 동일하거나 한 단계 상위의 주 버전인지 확인한 후 새 이전 작업을 만듭니다.

소스 데이터베이스 서버에 연결할 수 없음

Unable to connect to source database server 오류가 표시됩니다.

문제 원인

Database Migration Service에서 소스 데이터베이스 서버에 연결할 수 없습니다.

해결 방법

소스 및 대상 데이터베이스 인스턴스가 서로 통신할 수 있는지 확인합니다. 그런 다음 이전 작업의 설정을 정의할 때 표시된 필수 기본 요건을 모두 완료했는지 확인합니다.

Cloud SQL 대상 인스턴스 디스크 사용량이 0으로 감소함

이전 중에 디스크 사용량이 갑자기 0으로 떨어집니다.

문제 원인

전체 덤프 데이터를 가져올 때 실패할 수 있습니다. 이 경우 이전 프로세스가 데이터를 다시 로드하려고 시도합니다. 이 프로세스는 먼저 대상 인스턴스의 기존 데이터를 삭제한 후 (디스크 사용량이 0으로 표시되는 이유) 데이터를 다시 로드하려고 시도합니다.

해결 방법

로그 탐색기로 이동하여 리소스 목록에서 대상 인스턴스를 선택합니다. 다음과 유사한 로그 메시지를 찾습니다. DUMP_STAGE(RETRY): Attempt .../...: import failed: error..."; Clearing database and trying again." import failed: 텍스트 뒤에 있는 메시지를 찾아 근본 원인을 해결해 보세요.