AWS DMS 엔드포인트의 엔드포인트 설정을 추가하거나 수정하려면 어떻게 해야 하나요?

간략한 설명

---

엔드포인트 설정(이전의 추가 연결 속성)은 AWS DMS 작업에 사용할 추가 엔드포인트별 설정을 정의합니다. 예를 들어 엔드포인트 설정을 사용하여 특정 엔드포인트의 타임아웃, 시간대 및 파일 크기 설정을 제어할 수 있습니다. AWS DMS 엔드포인트에 대한 엔드포인트 설정을 추가하거나 수정하려면 다음 옵션을 사용하세요.

• AWS DMS 콘솔
• AWS Command Line Interface(AWS CLI)
• AWS CloudFormation.

해결 방법

참고: AWS CLI 명령을 실행할 때 오류가 발생하면 AWS CLI 오류 문제 해결을 참조하세요. 또한 최신 AWS CLI 버전을 사용하고 있는지 확인하세요.

AWS DMS 콘솔을 사용하여 추가 연결 속성이 있는 새 엔드포인트를 생성합니다.

1.AWS DMS 콘솔을 열고 엔드포인트를 생성할 AWS 리전을 선택합니다.

2.탐색 창에서 엔드포인트를 선택합니다.

3. 엔드포인트 생성을 선택합니다.

4.엔드포인트 유형을 선택한 다음 엔드포인트 구성 세부 정보를 입력합니다.

5.엔드포인트 설정 섹션을 확장합니다.

6.새 설정 추가를 선택합니다. 마법사 또는 JSON 편집기를 사용하여 엔드포인트의 이름과 값을 제공합니다.

예시:

{
  "CsvRowDelimiter": "\\n",
  "CsvDelimiter": ",",
  "CompressionType": "GZIP",
  "DataFormat": "parquet",
  "EnableStatistics": true,
  "DatePartitionEnabled": false
}

7.(선택 사항) 엔드포인트 연결 속성 사용을 선택합니다. 추가 연결 속성(ECA)을 입력합니다. 각 필드를 세미콜론으로 구분해야 합니다.

예시:

compressionType=GZIP;csvDelimiter=,;csvRowDelimiter=\n;datePartitionEnabled=false;

8.엔드포인트 연결 테스트 섹션을 확장합니다.

9.VPC 및 복제 인스턴스를 선택합니다.

9.    테스트 실행을 선택합니다.

10. 엔드포인트 생성을 선택합니다.

AWS DMS 콘솔을 사용하여 기존 엔드포인트에 엔드포인트 설정(또는 ECA)을 추가합니다.

1. AWS DMS 콘솔을 열고 엔드포인트가 있는 AWS 리전을 선택합니다.
2. 탐색 창에서 Endpoints를 선택한 다음 수정하려는 엔드포인트를 선택합니다.
3. 작업을 선택한 다음, 수정을 선택합니다.
4. 엔드포인트 설정 섹션을 확장한 다음 마법사 또는 JSON 편집기를 사용하여 엔드포인트 설정 키 값을 입력합니다.
5. 저장을 선택합니다.
6. 엔드포인트를 다시 선택합니다.
7. 작업을 선택한 다음 연결 테스트를 선택합니다.
8. 복제 인스턴스를 선택한 다음 테스트 실행을 선택합니다.

AWS CLI를 사용하여 사용자 지정 엔드포인트 설정이 포함된 새 엔드포인트를 생성합니다.

1.AWS CLI를 설치하고 구성합니다. 엔드포인트를 생성하려는 AWS 리전을 선택합니다.

2.create-endpoint 명령을 실행합니다.

aws dms create-endpoint --endpoint-identifier <value> --endpoint-type <value> --engine-name <value> --s3-settings ServiceAccessRoleArn=arn:aws:iam::1111111111111:role/<role-name>,BucketName=<bucket-name>,CompressionType=GZIP,MaxFileSize=32000

3.새 엔드포인트와 복제 인스턴스의 연결을 테스트합니다.

aws dms test-connection--replication-instance-arn <value>
--endpoint-arn <value>

AWS CLI를 사용하여 기존 엔드포인트에 엔드포인트 설정을 추가합니다.

1.AWS CLI를 설치하고 구성합니다. 엔드포인트를 생성하려는 AWS 리전을 선택합니다.

2.modify-endpoint 명령을 실행합니다.

aws dms modify-endpoint--endpoint-arn <value>
--s3-settings Rfc4180=true,AddColumnName=true,CdcInsertsOnly=true,MaxFileSize=64000

3.수정된 엔드포인트와 복제 인스턴스의 연결을 테스트합니다.

aws dms test-connection--replication-instance-arn <value>
--endpoint-arn <value>

AWS CloudFormation을 사용하여 사용자 지정 엔드포인트 설정이 포함된 새 엔드포인트를 생성합니다.

1.    CloudFormation 콘솔을 엽니다. 엔드포인트를 생성하려는 AWS 리전을 선택합니다.

2.스택 생성을 선택합니다.

3.템플릿 선택이 준비되었습니다를 선택합니다.

4.템플릿 파일 업로드를 선택합니다.

5.YAML 또는 JSON CloudFormation 파일을 생성합니다.

예시:

AWSTemplateFormatVersion: 2010-09-09
Description: "S3 target Endpoint"
Resources:
     S3TargetEndpoint:
        Type: AWS::DMS::Endpoint
        Properties:
            EndpointIdentifier: s3-Target-endpoint
            EndpointType: target
            EngineName: s3
            S3Settings:
                ServiceAccessRoleArn: arn:aws:iam::<AWS-account-number>:role/<role-name>
                BucketName: <bucket-name>
                AddColumnName: true
                CdcInsertsOnly: true
                MaxFileSize: 32000

6.    다음을 선택합니다.

7.스택 이름을 입력합니다.

8.DMS 리소스를 생성하는 데 필요한 권한을 가진 IAM 역할을 할당합니다.

9.    다음을 선택합니다.

10. 제출을 선택합니다.

AWS CloudFormation을 사용하여 기존 엔드포인트에 엔드포인트 설정을 추가합니다.

1.    CloudFormation 콘솔을 엽니다. 엔드포인트를 생성하려는 AWS 리전을 선택합니다.

2.기존 스택을 선택한 다음 업데이트를 선택합니다.

3.스택 업데이트 페이지에서 현재 템플릿 사용을 선택합니다.

4.템플릿 지정에서 템플릿 파일 업로드를 선택합니다. 다음 예제 템플릿을 사용하세요.

AWSTemplateFormatVersion: 2010-09-09
Description: "Endpoint S3 target"
Resources:
     BasicS3TargetEndpoint:
        Type: AWS::DMS::Endpoint
        Properties:
            EndpointIdentifier: s3-Target-endpoint
            EndpointType: target
            EngineName: s3
            S3Settings:
                ServiceAccessRoleArn: arn:aws:iam::<AWS-account-number>:role/<role-name>
                BucketName: <bucket-name>
                AddColumnName: true
                CdcInsertsAndUpdates: true
                MaxFileSize: 64000

5.    다음을 선택합니다.

6.스택 세부 정보 지정 페이지에서 다음을 선택합니다.

7.(선택 사항) 스택 옵션 구성 페이지의 태그에서 태그를 추가합니다. 권한에서 사용자를 대신하여 업데이트하려는 IAM 역할을 선택합니다. 그런 후 다음을 선택합니다.

8. 제출을 선택합니다.

레거시 추가 연결 속성

--extra-connection-attributes 옵션을 사용하여 엔드포인트를 생성하고 수정할 수 있습니다. 추가 연결 속성을 사용하면 엔드포인트 유형을 명시적으로 지정할 필요가 없습니다.

예시:

aws dms create-endpoint
--endpoint-identifier <value>
--endpoint-type <value>
--engine-name <value>
--username <value>
--password <value>
--server-name <value>
--port <value>
--extra-connection-attributes encryptionMode=SSE_KMS;maxFileSize=512


aws dms modify-endpoint
--endpoint-arn <value>
--extra-connection-attributes encryptionMode=SSE_KMS;maxFileSize=512

관련 정보

AWS DMS 엔드포인트 사용

AWS::DMS::엔드포인트