AWS DMS 마이그레이션 작업 실패의 원인이 되는 엔드포인트 문제를 어떻게 해결해야 합니까?

해결 방법

엔드포인트 연결 구성 검토

작업의 소스 또는 대상 엔드포인트의 연결을 검토하려면 다음 단계를 완료하십시오.

1. AWS DMS 콘솔을 엽니다.
2. 탐색 창에서 Migrate or replicate(마이그레이션 또는 복제)를 선택합니다.
3. Tasks(작업)를 선택한 다음 작업을 선택합니다.
4. Details(세부 정보) 탭에서 Connectivity and security(연결 및 보안) 섹션의 복제 인스턴스 이름을 확인하여 올바른 복제 인스턴스를 사용하고 있는지 확인합니다.
5. Summary(요약) 섹션에서 소스 또는 대상 엔드포인트를 선택하여 엔드포인트 인터페이스를 검토합니다.
6. Connections(연결) 탭을 선택한 다음 Test Connections(연결 테스트)를 선택합니다.
7. Replication(복제) 인스턴스를 선택한 다음 Run Test(테스트 실행)를 선택합니다.

네트워크 구성으로 인해 연결 테스트 결과가 실패 상태인 경우 다음과 같은 시간 초과 오류 메시지가 나타납니다.

Oracle의 경우:

'Test Endpoint failed: Application-Status: 1020912, Application-Message: ORA-12170: TNS:Connect timeout occurred OCI connection failure.'

PostgreSQL의 경우:

'Test Endpoint failed: Application-Status: 1020912, Application-Message: Failed to connect Network error has occurred, Application-Detailed-Message: RetCode: SQL_ERROR SqlState: 08001 NativeError: 101 Message: '

Amazon DocumentDB(MongoDB 호환)의 경우:

'Test Endpoint failed: Application-Status: 1020912, Application-Message: Failed to create new client connection Failed to connect to database., Application-Detailed-Message: Error verifying connection'

이 문제를 해결하려면 AWS DMS 엔드포인트 연결 실패 문제를 해결하려면 어떻게 해야 합니까?를 참조하십시오. 그런 다음 연결을 다시 테스트합니다.

엔드포인트 인증 구성 검토

AWS DMS 엔드포인트 연결 테스트에서 인증 오류 메시지가 표시될 수 있습니다. 인증 오류 메시지 문제를 해결하려면 AWS DMS 엔드포인트에 대한 액세스를 올바르게 구성했는지 확인하십시오.

다음 단계를 완료하십시오.

1. AWS DMS 콘솔을 엽니다.
2. 탐색 창에서 Migrate or replicate(마이그레이션 또는 복제)를 선택합니다.
3. Endpoints(엔드포인트)를 선택한 다음, 엔드포인트를 선택합니다.
4. Actions(작업)를 선택한 다음, Modify(수정)를 선택합니다.
5. Endpoint Configuration(엔드포인트 구성) 섹션에서 Access to endpoint database(엔드포인트 데이터베이스에 액세스)에 대해 다음을 검토합니다.
   액세스 정보 수동 제공을 선택한 경우 서버 이름 필드에 정의한 호스트에 포트(3306) 또는 프로토콜(HTTP)이 포함되어 있지 않은지 확인합니다. 데이터베이스에 동일한 사용자 이름, 암호 및 SSL 값을 지정했는지 확인합니다.
   AWS Secrets Manager를 선택하고 올바른 보안 관리자 및 SSL 모드를 선택한 경우 일반 AWS DMS 전제 조건 및 AWS Secrets Manager를 사용하여 Amazon VPC 엔드포인트 설정을 참조하십시오.
   Kerberos 인증을 선택하고 올바른 서버 이름, 포트 및 사용자 이름을 사용한 경우전제 조건 및 AWS DMS에서 Kerberos 인증을 사용할 때의 제한 사항을 참조하십시오.
   IAM 인증을 선택하고 올바른 서버 이름, 포트, 사용자 이름 및 AWS Identity and Access Management(IAM) 역할을 사용한 경우 IAM 역할에 올바른 정책을 연결했는지 확인하십시오. 자세한 내용은 AWS DMS의 Amazon RDS 엔드포인트에 대한 IAM 인증 구성 및 IAM 데이터베이스 인증 제한 사항에서 DMS 콘솔 탭을 선택하십시오.

엔드포인트 설정 및 ECA 검토

작업을 실행할 때 Oracle 플러그형 데이터베이스(PDB)를 소스로 사용하는 경우 다음과 같은 오류 메시지가 나타날 수 있습니다.

"Test Endpoint failed: Application-Status: 1020912, Application-Message: Log Miner is not supported in Oracle PDB environment Endpoint initialization failed."

이 오류는 복제 방법을 Binary Reader 대신 Log Miner로 구성했기 때문에 발생합니다.

AWS DMS 작업에서 사용하는 복제 방법을 변경하려면 다음 단계를 완료하십시오.

1. AWS DMS 콘솔을 엽니다.
2. 탐색 창에서 Migrate or replicate(마이그레이션 또는 복제)를 선택합니다.
3. Tasks(작업)를 선택한 다음 작업을 선택합니다.
4. Summary(요약) 섹션에서 문 소스 링크를 선택합니다.
5. Actions(작업)를 선택한 다음, Modify(수정)를 선택합니다.
6. Endpoint Settings(엔드포인트 설정)에서 Use endpoint connection attributes(엔드포인트 연결 특성 사용)를 선택합니다.
7. 복제 방식을 Binary Reader로 구성하려면 Extra connection attributes (ECAs)(추가 연결 속성(ECA)) 필드에 useLogMinerReader=N;useBfile=Y; 속성을 입력합니다.
8. Save(저장)를 선택합니다.

쿼리 시간 초과 오류 검토

AWS DMS 작업을 시작할 때 다음과 같은 PostgreSQL 쿼리 시간 초과 오류 메시지가 표시될 수 있습니다.

"]E: RetCode: SQL_ERROR SqlState: 57014 NativeError: 1 Message: ERROR: canceling statement due to statement timeout; Error while executing the query [1022502] (ar_odbc_stmt.c:2738)"

AWS DMS 작업 요청에 대해 소스 데이터베이스의 ExecuteTimeout 매개변수를 조정하려면 다음 단계를 완료하십시오.

1. AWS DMS 콘솔을 엽니다.
2. 탐색 창에서 Endpoints(엔드포인트)를 선택한 다음 엔드포인트를 선택합니다.
3. Action(작업)을 선택한 다음, Modify(수정)를 선택합니다.
4. Endpoint Settings(엔드포인트 설정) 섹션에서 Use endpoint connection attributes(엔드포인트 연결 특성 사용)를 선택합니다.
5. 사용자 지정 executeTimeout을 구성하려면 Extra connection attributes (ECAs)(추가 연결 속성(ECA)) 필드에 **executeTimeout=3600;**을 입력합니다.
6. Save(저장)를 선택합니다.

시간 초과 문제가 계속 발생하는 경우, ‘ERROR: canceling statement due to statement timeout’ 오류 메시지와 함께 실패하는 AWS DMS 작업 문제를 해결하려면 어떻게 해야 합니까?를 참조하십시오.

관련 정보

AWS DMS 엔드포인트를 사용한 작업

소스 및 대상 엔드포인트 생성

고급 엔드포인트 구성