AWS DMS 사용 예제 AWS CLI - AWS Command Line Interface
작업

이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS DMS 사용 예제 AWS CLI

다음 코드 예제에서는 AWS Command Line Interface 와 함께 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다 AWS DMS.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

다음 코드 예시에서는 add-tags-to-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스에 태그를 추가하려면

다음 add-tags-to-resource 예제에서는 복제 인스턴스에 태그를 추가합니다.

aws dms add-tags-to-resource \
    --resource-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \
    --tags Key=Environment,Value=PROD Key=Project,Value=dbMigration

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 리소스 태그 지정을 참조하세요.

  • 자세한 API 내용은 명령 참조AddTagsToResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-endpoint을 사용하는 방법을 보여 줍니다.

AWS CLI

엔드포인트를 생성하려면

다음 create-endpoint 예제에서는 Amazon S3 소스에 대한 엔드포인트를 생성합니다.

aws dms create-endpoint \
    --endpoint-type source \
    --engine-name s3 \
    --endpoint-identifier src-endpoint \
    --s3-settings file://s3-settings.json

s3-settings.json의 콘텐츠:

{
    "BucketName":"my-corp-data",
    "BucketFolder":"sourcedata",
    "ServiceAccessRoleArn":"arn:aws:iam::123456789012:role/my-s3-access-role"
}

출력:

{
    "Endpoint": {
        "EndpointIdentifier": "src-endpoint",
        "EndpointType": "SOURCE",
        "EngineName": "s3",
        "EngineDisplayName": "Amazon S3",
        "ExtraConnectionAttributes": "bucketFolder=sourcedata;bucketName=my-corp-data;compressionType=NONE;csvDelimiter=,;csvRowDelimiter=\\n;",
        "Status": "active",
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:GUVAFG34EECUOJ6QVZ56DAHT3U",
        "SslMode": "none",
        "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role",
        "S3Settings": {
            "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role",
            "CsvRowDelimiter": "\\n",
            "CsvDelimiter": ",",
            "BucketFolder": "sourcedata",
            "BucketName": "my-corp-data",
            "CompressionType": "NONE",
            "EnableStatistics": true
        }
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 엔드포인트 작업을 AWS DMS 참조하세요.

  • 자세한 API 내용은 명령 참조CreateEndpoint의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-event-subscription을 사용하는 방법을 보여 줍니다.

AWS CLI

이벤트 구독을 나열하려면

다음 create-event-subscription 예제에서는 Amazon SNS 주제()에 대한 이벤트 구독을 생성합니다my-sns-topic.

aws dms create-event-subscription \
    --subscription-name my-dms-events \
    --sns-topic-arn arn:aws:sns:us-east-1:123456789012:my-sns-topic

출력:

{
    "EventSubscription": {
        "CustomerAwsId": "123456789012",
        "CustSubscriptionId": "my-dms-events",
        "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:my-sns-topic",
        "Status": "creating",
        "SubscriptionCreationTime": "2020-05-21 21:58:38.598",
        "Enabled": true
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 이벤트 및 알림 작업을 참조하세요.

다음 코드 예시에서는 create-replication-instance을 사용하는 방법을 보여 줍니다.

AWS CLI

복제 인스턴스를 생성하려면

다음 create-replication-instance 예제에서는 복제 인스턴스를 생성합니다.

aws dms create-replication-instance \
    --replication-instance-identifier my-repl-instance \
    --replication-instance-class dms.t2.micro \
    --allocated-storage 5

출력:

{
    "ReplicationInstance": {
        "ReplicationInstanceIdentifier": "my-repl-instance",
        "ReplicationInstanceClass": "dms.t2.micro",
        "ReplicationInstanceStatus": "creating",
        "AllocatedStorage": 5,
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-f839b688",
                "Status": "active"
            }
        ],
        "ReplicationSubnetGroup": {
            "ReplicationSubnetGroupIdentifier": "default",
            "ReplicationSubnetGroupDescription": "default",
            "VpcId": "vpc-136a4c6a",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-da327bf6",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-42599426",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1d"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-bac383e0",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1c"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-6746046b",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1f"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-d7c825e8",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1e"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-cbfff283",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1b"
                    },
                    "SubnetStatus": "Active"
                }
            ]
        },
        "PreferredMaintenanceWindow": "sat:12:35-sat:13:05",
        "PendingModifiedValues": {},
        "MultiAZ": false,
        "EngineVersion": "3.3.2",
        "AutoMinorVersionUpgrade": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/f7bc0f8e-1a3a-4ace-9faa-e8494fa3921a",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:ZK2VQBUWFDBAWHIXHAYG5G2PKY",
        "PubliclyAccessible": true
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 복제 인스턴스 작업을 AWS DMS 참조하세요.

다음 코드 예시에서는 create-replication-subnet-group을 사용하는 방법을 보여 줍니다.

AWS CLI

서브넷 그룹을 생성하려면

다음 create-replication-subnet-group 예제에서는 3개의 서브넷으로 구성된 그룹을 생성합니다.

aws dms create-replication-subnet-group \
    --replication-subnet-group-identifier my-subnet-group \
    --replication-subnet-group-description "my subnet group" \
    --subnet-ids subnet-da327bf6 subnet-bac383e0 subnet-d7c825e8

출력:

{
    "ReplicationSubnetGroup": {
        "ReplicationSubnetGroupIdentifier": "my-subnet-group",
        "ReplicationSubnetGroupDescription": "my subnet group",
        "VpcId": "vpc-136a4c6a",
        "SubnetGroupStatus": "Complete",
        "Subnets": [
            {
                "SubnetIdentifier": "subnet-da327bf6",
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1a"
                },
                "SubnetStatus": "Active"
            },
            {
                "SubnetIdentifier": "subnet-bac383e0",
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1c"
                },
                "SubnetStatus": "Active"
            },
            {
                "SubnetIdentifier": "subnet-d7c825e8",
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1e"
                },
                "SubnetStatus": "Active"
            }
        ]
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 복제 인스턴스용 네트워크 설정을 참조하세요.

다음 코드 예시에서는 create-replication-task을 사용하는 방법을 보여 줍니다.

AWS CLI

복제 작업을 생성하려면

다음 create-replication-task 예제에서는 복제 작업을 생성합니다.

aws dms create-replication-task \
    --replication-task-identifier movedata \
    --source-endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA \
    --target-endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U \
    --replication-instance-arn $RI_ARN \
    --migration-type full-load \
    --table-mappings file://table-mappings.json

table-mappings.json의 콘텐츠:

{
    "rules": [
        {
            "rule-type": "selection",
            "rule-id": "1",
            "rule-name": "1",
            "object-locator": {
                "schema-name": "prodrep",
                "table-name": "%"
            },
            "rule-action": "include",
            "filters": []
        }
    ]
}

출력:

{
    "ReplicationTask": {
        "ReplicationTaskIdentifier": "moveit2",
        "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "MigrationType": "full-load",
        "TableMappings": ...output omitted... ,
        "ReplicationTaskSettings": ...output omitted... ,
        "Status": "creating",
        "ReplicationTaskCreationDate": 1590524772.505,
        "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 작업 작업을 AWS DMS 참조하세요.

다음 코드 예시에서는 delete-connection을 사용하는 방법을 보여 줍니다.

AWS CLI

연결을 삭제하려면

다음 delete-connection 예제에서는 복제 인스턴스에서 엔드포인트의 연결을 해제합니다.

aws dms delete-connection \
    --endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA \
    --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE

출력:

{
    "Connection": {
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "Status": "deleting",
        "EndpointIdentifier": "src-database-1",
        "ReplicationInstanceIdentifier": "my-repl-instance"
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 https://docs.aws.amazon.com/dms/최신/userguide/CHAP_Endpoints.Creating.html을 참조하세요.

  • 자세한 API 내용은 명령 참조DeleteConnection의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-endpoint을 사용하는 방법을 보여 줍니다.

AWS CLI

엔드포인트를 삭제하려면

다음 delete-endpoint 예제에서는 엔드포인트를 삭제합니다.

aws dms delete-endpoint \
    --endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:OUJJVXO4XZ4CYTSEG5XGMN2R3Y

출력:

{
    "Endpoint": {
        "EndpointIdentifier": "src-endpoint",
        "EndpointType": "SOURCE",
        "EngineName": "s3",
        "EngineDisplayName": "Amazon S3",
        "ExtraConnectionAttributes": "bucketFolder=sourcedata;bucketName=my-corp-data;compressionType=NONE;csvDelimiter=,;csvRowDelimiter=\\n;",
        "Status": "deleting",
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:OUJJVXO4XZ4CYTSEG5XGMN2R3Y",
        "SslMode": "none",
        "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role",
        "S3Settings": {
            "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role",
            "CsvRowDelimiter": "\\n",
            "CsvDelimiter": ",",
            "BucketFolder": "sourcedata",
            "BucketName": "my-corp-data",
            "CompressionType": "NONE",
            "EnableStatistics": true
        }
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 엔드포인트 작업을 AWS DMS 참조하세요.

  • 자세한 API 내용은 명령 참조DeleteEndpoint의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-event-subscription을 사용하는 방법을 보여 줍니다.

AWS CLI

이벤트 구독을 삭제하려면

다음 delete-event-subscription 예제에서는 Amazon SNS 주제에 대한 구독을 삭제합니다.

aws dms delete-event-subscription \
    --subscription-name "my-dms-events"

출력:

{
    "EventSubscription": {
        "CustomerAwsId": "123456789012",
        "CustSubscriptionId": "my-dms-events",
        "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:my-sns-topic",
        "Status": "deleting",
        "SubscriptionCreationTime": "2020-05-21 21:58:38.598",
        "Enabled": true
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 이벤트 및 알림 작업을 참조하세요.

다음 코드 예시에서는 delete-replication-instance을 사용하는 방법을 보여 줍니다.

AWS CLI

복제 인스턴스를 삭제하려면

다음 delete-replication-instance 예시에서는 복제 인스턴스를 삭제합니다.

aws dms delete-replication-instance \
    --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE

출력:

{
    "ReplicationInstance": {
        "ReplicationInstanceIdentifier": "my-repl-instance",
        "ReplicationInstanceClass": "dms.t2.micro",
        "ReplicationInstanceStatus": "deleting",
        "AllocatedStorage": 5,
        "InstanceCreateTime": 1590011235.952,
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-f839b688",
                "Status": "active"
            }
        ],
        "AvailabilityZone": "us-east-1e",
        "ReplicationSubnetGroup": {
            "ReplicationSubnetGroupIdentifier": "default",
            "ReplicationSubnetGroupDescription": "default",
            "VpcId": "vpc-136a4c6a",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-da327bf6",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-42599426",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1d"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-bac383e0",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1c"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-6746046b",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1f"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-d7c825e8",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1e"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-cbfff283",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1b"
                    },
                    "SubnetStatus": "Active"
                }
            ]
        },
        "PreferredMaintenanceWindow": "wed:11:42-wed:12:12",
        "PendingModifiedValues": {},
        "MultiAZ": true,
        "EngineVersion": "3.3.2",
        "AutoMinorVersionUpgrade": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/f7bc0f8e-1a3a-4ace-9faa-e8494fa3921a",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "ReplicationInstancePublicIpAddress": "54.225.120.92",
        "ReplicationInstancePrivateIpAddress": "172.31.30.121",
        "ReplicationInstancePublicIpAddresses": [
            "54.225.120.92",
            "3.230.18.248"
        ],
        "ReplicationInstancePrivateIpAddresses": [
            "172.31.30.121",
            "172.31.75.90"
        ],
        "PubliclyAccessible": true,
        "SecondaryAvailabilityZone": "us-east-1b"
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 복제 인스턴스 작업을 AWS DMS 참조하세요.

다음 코드 예시에서는 delete-replication-subnet-group을 사용하는 방법을 보여 줍니다.

AWS CLI

서브넷 그룹을 삭제하려면

다음 delete-replication-subnet-group 예제에서는 서브넷 그룹을 삭제합니다.

aws dms delete-replication-subnet-group \
--replication-subnet-group-identifier my-subnet-group

출력:

(none)

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 복제 인스턴스용 네트워크 설정을 참조하세요.

다음 코드 예시에서는 delete-replication-task을 사용하는 방법을 보여 줍니다.

AWS CLI

복제 작업을 삭제하려면

다음 delete-replication-task 예제에서는 복제 작업을 삭제합니다.

aws dms delete-replication-task \
    --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII

출력:

{
    "ReplicationTask": {
        "ReplicationTaskIdentifier": "moveit2",
        "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "MigrationType": "full-load",
        "TableMappings": ...output omitted...,
        "ReplicationTaskSettings": ...output omitted...,
        "Status": "deleting",
        "StopReason": "Stop Reason FULL_LOAD_ONLY_FINISHED",
        "ReplicationTaskCreationDate": 1590524772.505,
        "ReplicationTaskStartDate": 1590789988.677,
        "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 작업 작업을 AWS DMS 참조하세요.

다음 코드 예시에서는 describe-account-attributes을 사용하는 방법을 보여 줍니다.

AWS CLI

계정 속성을 설명하려면

다음 describe-account-attributes 예제에서는 AWS 계정의 속성을 나열합니다.

aws dms describe-account-attributes

출력:

{
    "AccountQuotas": [
        {
            "AccountQuotaName": "ReplicationInstances",
            "Used": 1,
            "Max": 20
        },
        {
            "AccountQuotaName": "AllocatedStorage",
            "Used": 5,
            "Max": 10000
        },

        ...remaining output omitted...

    ],
    "UniqueAccountIdentifier": "cqahfbfy5xee"
}

다음 코드 예시에서는 describe-certificates을 사용하는 방법을 보여 줍니다.

AWS CLI

사용 가능한 인증서를 나열하려면

다음 describe-certificates 예제에서는 AWS 계정에서 사용 가능한 인증서를 나열합니다.

aws dms describe-certificates

출력:

{
    "Certificates": [
        {
            "CertificateIdentifier": "my-cert",
            "CertificateCreationDate": 1543259542.506,
            "CertificatePem": "-----BEGIN CERTIFICATE-----\nMIID9DCCAtygAwIBAgIBQjANBgkqhkiG9w0BAQ ...U"

            ... remaining output omittted ...

        }
    ]
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 사용을 SSL 참조하세요.

다음 코드 예시에서는 describe-connections을 사용하는 방법을 보여 줍니다.

AWS CLI

연결을 설명하려면

다음 describe-connections 예제에서는 복제 인스턴스와 엔드포인트 간에 테스트한 연결을 나열합니다.

aws dms describe-connections

출력:

{
    "Connections": [
        {
            "Status": "successful",
            "ReplicationInstanceIdentifier": "test",
            "EndpointArn": "arn:aws:dms:us-east-arn:aws:dms:us-east-1:123456789012:endpoint:ZW5UAN6P4E77EC7YWHK4RZZ3BE",
            "EndpointIdentifier": "testsrc1",
            "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:6UTDJGBOUS3VI3SUWA66XFJCJQ"
        }
    ]
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 소스 및 대상 엔드포인트 생성을 참조하세요.

  • 자세한 API 내용은 명령 참조DescribeConnections의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-endpoint-types을 사용하는 방법을 보여 줍니다.

AWS CLI

사용 가능한 엔드포인트 유형을 나열하려면

다음 describe-endpoint-types 예제에서는 사용 가능한 내SQL 엔드포인트 유형을 나열합니다.

aws dms describe-endpoint-types \
    --filters "Name=engine-name,Values=mysql"

출력:

{
    "SupportedEndpointTypes": [
        {
            "EngineName": "mysql",
            "SupportsCDC": true,
            "EndpointType": "source",
            "EngineDisplayName": "MySQL"
        },
        {
            "EngineName": "mysql",
            "SupportsCDC": true,
            "EndpointType": "target",
            "EngineDisplayName": "MySQL"
        }
    ]
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 엔드포인트 < AWS DMShttps://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.html>`__ 작업을 참조하세요.

다음 코드 예시에서는 describe-endpoints을 사용하는 방법을 보여 줍니다.

AWS CLI

엔드포인트를 설명하려면

다음 describe-endpoints 예제에서는 AWS 계정의 엔드포인트를 나열합니다.

aws dms describe-endpoints

출력:

{
    "Endpoints": [
        {
            "Username": "dms",
            "Status": "active",
            "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:SF2WOFLWYWKVEOHID2EKLP3SJI",
            "ServerName": "ec2-52-32-48-61.us-west-2.compute.amazonaws.com",
            "EndpointType": "SOURCE",
            "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/94d5c4e7-4e4c-44be-b58a-c8da7adf57cd",
            "DatabaseName": "test",
            "EngineName": "mysql",
            "EndpointIdentifier": "pri100",
            "Port": 8193
        },
        {
            "Username": "admin",
            "Status": "active",
            "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:TJJZCIH3CJ24TJRU4VC32WEWFR",
            "ServerName": "test.example.com",
            "EndpointType": "SOURCE",
            "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/2431021b-1cf2-a2d4-77b2-59a9e4bce323",
            "DatabaseName": "EMPL",
            "EngineName": "oracle",
            "EndpointIdentifier": "test",
            "Port": 1521
        }
    ]
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 엔드포인트 작업을 AWS DMS 참조하세요.

  • 자세한 API 내용은 명령 참조DescribeEndpoints의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-event-categories을 사용하는 방법을 보여 줍니다.

AWS CLI

이벤트 범주를 설명하려면

다음 describe-event-categories 예제에서는 사용 가능한 이벤트 범주를 나열합니다.

aws dms describe-event-categories

출력:

{
    "EventCategoryGroupList": [
        {
            "SourceType": "replication-instance",
            "EventCategories": [
                "low storage",
                "configuration change",
                "maintenance",
                "deletion",
                "creation",
                "failover",
                "failure"
            ]
        },
        {
            "SourceType": "replication-task",
            "EventCategories": [
                "configuration change",
                "state change",
                "deletion",
                "creation",
                "failure"
            ]
        }
    ]
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 이벤트 및 알림 작업을 참조하세요.

다음 코드 예시에서는 describe-event-subscriptions을 사용하는 방법을 보여 줍니다.

AWS CLI

이벤트 구독을 설명하려면

다음 describe-event-subscriptions 예제에서는 Amazon SNS 주제에 대한 이벤트 구독을 나열합니다.

aws dms describe-event-subscriptions

출력:

{
    "EventSubscriptionsList": [
        {
            "CustomerAwsId": "123456789012",
            "CustSubscriptionId": "my-dms-events",
            "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:my-sns-topic",
            "Status": "deleting",
            "SubscriptionCreationTime": "2020-05-21 22:28:51.924",
            "Enabled": true
        }
    ]
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 이벤트 및 알림 작업을 참조하세요.

다음 코드 예시에서는 describe-events을 사용하는 방법을 보여 줍니다.

AWS CLI

DMS 이벤트를 나열하려면

다음 describe-events 예제에서는 복제 인스턴스에서 시작된 이벤트를 나열합니다.

aws dms describe-events \
    --source-type "replication-instance"

출력:

{
    "Events": [
        {
            "SourceIdentifier": "my-repl-instance",
            "SourceType": "replication-instance",
            "Message": "Replication application shutdown",
            "EventCategories": [],
            "Date": 1590771645.776
        }
    ]
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 이벤트 및 알림 작업을 참조하세요.

  • 자세한 API 내용은 명령 참조DescribeEvents의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-orderable-replication-instances을 사용하는 방법을 보여 줍니다.

AWS CLI

주문 가능한 복제 인스턴스를 설명하려면

다음 describe-orderable-replication-instances 예제에서는 주문할 수 있는 복제 인스턴스 유형을 나열합니다.

aws dms describe-orderable-replication-instances

출력:

{
    "OrderableReplicationInstances": [
        {
            "EngineVersion": "3.3.2",
            "ReplicationInstanceClass": "dms.c4.2xlarge",
            "StorageType": "gp2",
            "MinAllocatedStorage": 5,
            "MaxAllocatedStorage": 6144,
            "DefaultAllocatedStorage": 100,
            "IncludedAllocatedStorage": 100,
            "AvailabilityZones": [
                "us-east-1a",
                "us-east-1b",
                "us-east-1c",
                "us-east-1d",
                "us-east-1e",
                "us-east-1f"
            ]
        },
        {
            "EngineVersion": "3.3.2",
            "ReplicationInstanceClass": "dms.c4.4xlarge",
            "StorageType": "gp2",
            "MinAllocatedStorage": 5,
            "MaxAllocatedStorage": 6144,
            "DefaultAllocatedStorage": 100,
            "IncludedAllocatedStorage": 100,
            "AvailabilityZones": [
                "us-east-1a",
                "us-east-1b",
                "us-east-1c",
                "us-east-1d",
                "us-east-1e",
                "us-east-1f"
            ]
        },

        ...remaining output omitted...

    }

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 복제 인스턴스 작업을 AWS DMS 참조하세요.

다음 코드 예시에서는 describe-refresh-schemas-status을 사용하는 방법을 보여 줍니다.

AWS CLI

엔드포인트의 새로 고침 상태를 나열하려면

다음 describe-refresh-schemas-status 예제에서는 이전 새로 고침 요청의 상태를 반환합니다.

aws dms describe-refresh-schemas-status \
    --endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA

출력:

{
    "RefreshSchemasStatus": {
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "Status": "successful",
        "LastRefreshDate": 1590786544.605
    }
}

다음 코드 예시에서는 describe-replication-instances을 사용하는 방법을 보여 줍니다.

AWS CLI

복제 인스턴스를 설명하려면

다음 describe-replication-instances 예제에서는 AWS 계정의 복제 인스턴스를 나열합니다.

aws dms describe-replication-instances

출력:

{
    "ReplicationInstances": [
        {
            "ReplicationInstanceIdentifier": "my-repl-instance",
            "ReplicationInstanceClass": "dms.t2.micro",
            "ReplicationInstanceStatus": "available",
            "AllocatedStorage": 5,
            "InstanceCreateTime": 1590011235.952,
            "VpcSecurityGroups": [
                {
                    "VpcSecurityGroupId": "sg-f839b688",
                    "Status": "active"
                }
            ],
            "AvailabilityZone": "us-east-1e",
            "ReplicationSubnetGroup": {
                "ReplicationSubnetGroupIdentifier": "default",
                "ReplicationSubnetGroupDescription": "default",
                "VpcId": "vpc-136a4c6a",
                "SubnetGroupStatus": "Complete",
                "Subnets": [
                    {
                        "SubnetIdentifier": "subnet-da327bf6",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1a"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-42599426",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1d"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-bac383e0",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1c"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-6746046b",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1f"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-d7c825e8",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1e"
                        },
                        "SubnetStatus": "Active"
                    },
                    {
                        "SubnetIdentifier": "subnet-cbfff283",
                        "SubnetAvailabilityZone": {
                            "Name": "us-east-1b"
                        },
                        "SubnetStatus": "Active"
                    }
                ]
            },
            "PreferredMaintenanceWindow": "wed:11:42-wed:12:12",
            "PendingModifiedValues": {
                "MultiAZ": true
            },
            "MultiAZ": false,
            "EngineVersion": "3.3.2",
            "AutoMinorVersionUpgrade": true,
            "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/f7bc0f8e-1a3a-4ace-9faa-e8494fa3921a",
            "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
            "ReplicationInstancePublicIpAddress": "3.230.18.248",
            "ReplicationInstancePrivateIpAddress": "172.31.75.90",
            "ReplicationInstancePublicIpAddresses": [
                "3.230.18.248"
            ],
            "ReplicationInstancePrivateIpAddresses": [
                "172.31.75.90"
            ],
            "PubliclyAccessible": true,
            "FreeUntil": 1590194829.267
        }
    ]
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 복제 인스턴스 작업을 AWS DMS 참조하세요.

다음 코드 예시에서는 describe-replication-subnet-groups을 사용하는 방법을 보여 줍니다.

AWS CLI

사용 가능한 서브넷 그룹을 표시하려면

다음 describe-replication-subnet-groups 예제에서는 사용 가능한 서브넷 그룹을 나열합니다.

aws dms describe-replication-subnet-groups \
    --filter "Name=replication-subnet-group-id,Values=my-subnet-group"

출력:

{
    "ReplicationSubnetGroups": [
        {
            "ReplicationSubnetGroupIdentifier": "my-subnet-group",
            "ReplicationSubnetGroupDescription": "my subnet group",
            "VpcId": "vpc-136a4c6a",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-da327bf6",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-bac383e0",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1c"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-d7c825e8",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1e"
                    },
                    "SubnetStatus": "Active"
                }
            ]
        }
    ]
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 복제 인스턴스용 네트워크 설정을 참조하세요.

다음 코드 예시에서는 describe-replication-task-assessment-results을 사용하는 방법을 보여 줍니다.

AWS CLI

복제 작업 평가 결과를 나열하려면

다음 describe-replication-task-assessment-results 예제에서는 이전 작업 평가의 결과를 나열합니다.

aws dms describe-replication-task-assessment-results

출력:

{
    "ReplicationTaskAssessmentResults": [
        {
            "ReplicationTaskIdentifier": "moveit2",
            "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII",
            "ReplicationTaskLastAssessmentDate": 1590790230.0,
            "AssessmentStatus": "No issues found",
            "AssessmentResultsFile": "moveit2/2020-05-29-22-10"
        }
    ]
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 작업 평가 보고서 생성을 참조하세요.

다음 코드 예시에서는 describe-replication-tasks을 사용하는 방법을 보여 줍니다.

AWS CLI

복제 작업을 설명하려면

다음 describe-replication-tasks 예제에서는 현재 복제 작업을 설명합니다.

aws dms describe-replication-tasks

출력:

{
    "ReplicationTasks": [
        {
            "ReplicationTaskIdentifier": "moveit2",
            "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
            "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
            "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
            "MigrationType": "full-load",
            "TableMappings": ...output omitted... ,
            "ReplicationTaskSettings": ...output omitted... ,
            "Status": "stopped",
            "StopReason": "Stop Reason FULL_LOAD_ONLY_FINISHED",
            "ReplicationTaskCreationDate": 1590524772.505,
            "ReplicationTaskStartDate": 1590619805.212,
            "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII",
            "ReplicationTaskStats": {
                "FullLoadProgressPercent": 100,
                "ElapsedTimeMillis": 0,
                "TablesLoaded": 0,
                "TablesLoading": 0,
                "TablesQueued": 0,
                "TablesErrored": 0,
                "FreshStartDate": 1590619811.528,
                "StartDate": 1590619811.528,
                "StopDate": 1590619842.068
            }
        }
    ]
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 작업 작업을 AWS DMS 참조하세요.

다음 코드 예시에서는 describe-schemas을 사용하는 방법을 보여 줍니다.

AWS CLI

데이터베이스 스키마를 설명하려면

다음 describe-schemas 예제에서는 엔드포인트에서 사용 가능한 테이블을 나열합니다.

aws dms describe-schemas \
    --endpoint-arn "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA"

출력:

{
    "Schemas": [
        "prodrep"
    ]
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 주제 제목을 참조하세요.

  • 자세한 API 내용은 명령 참조DescribeSchemas의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-tags-for-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스의 태그를 나열하려면

다음 list-tags-for-resource 예제에서는 복제 인스턴스의 태그를 나열합니다.

aws dms list-tags-for-resource \
    --resource-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE

출력:

{
    "TagList": [
        {
            "Key": "Project",
            "Value": "dbMigration"
        },
        {
            "Key": "Environment",
            "Value": "PROD"
        }
    ]
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 리소스 태그 지정을 참조하세요.

  • 자세한 API 내용은 명령 참조ListTagsForResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 modify-endpoint을 사용하는 방법을 보여 줍니다.

AWS CLI

엔드포인트를 수정하려면

다음 modify-endpoint 예제에서는 엔드포인트에 추가 연결 속성을 추가합니다.

aws dms modify-endpoint \
    --endpoint-arn "arn:aws:dms:us-east-1:123456789012:endpoint:GUVAFG34EECUOJ6QVZ56DAHT3U" \
    --extra-connection-attributes "compressionType=GZIP"

출력:

{
    "Endpoint": {
        "EndpointIdentifier": "src-endpoint",
        "EndpointType": "SOURCE",
        "EngineName": "s3",
        "EngineDisplayName": "Amazon S3",
        "ExtraConnectionAttributes": "compressionType=GZIP;csvDelimiter=,;csvRowDelimiter=\\n;",
        "Status": "active",
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:GUVAFG34EECUOJ6QVZ56DAHT3U",
        "SslMode": "none",
        "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role",
        "S3Settings": {
            "ServiceAccessRoleArn": "arn:aws:iam::123456789012:role/my-s3-access-role",
            "CsvRowDelimiter": "\\n",
            "CsvDelimiter": ",",
            "BucketFolder": "",
            "BucketName": "",
            "CompressionType": "GZIP",
            "EnableStatistics": true
        }
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 엔드포인트 작업 AWS DMS <https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.html>`__을 참조하세요.

  • 자세한 API 내용은 명령 참조ModifyEndpoint의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 modify-event-subscription을 사용하는 방법을 보여 줍니다.

AWS CLI

이벤트 구독을 수정하려면

다음 modify-event-subscription 예제에서는 이벤트 구독의 소스 유형을 변경합니다.

aws dms modify-event-subscription \
    --subscription-name "my-dms-events" \
    --source-type replication-task

출력:

{
    "EventSubscription": {
        "CustomerAwsId": "123456789012",
        "CustSubscriptionId": "my-dms-events",
        "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:my-sns-topic",
        "Status": "modifying",
        "SubscriptionCreationTime": "2020-05-29 17:04:40.262",
        "SourceType": "replication-task",
        "Enabled": true
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 이벤트 및 알림 작업을 참조하세요.

다음 코드 예시에서는 modify-replication-instance을 사용하는 방법을 보여 줍니다.

AWS CLI

복제 인스턴스를 수정하려면

다음 modify-replication-instance 예제에서는 다중 AZ 배포를 사용하도록 복제 인스턴스를 수정합니다.

aws dms modify-replication-instance \
     --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \
     --multi-az

출력:

{
    "ReplicationInstance": {
        "ReplicationInstanceIdentifier": "my-repl-instance",
        "ReplicationInstanceClass": "dms.t2.micro",
        "ReplicationInstanceStatus": "available",
        "AllocatedStorage": 5,
        "InstanceCreateTime": 1590011235.952,

        ...output omitted...

        "PendingModifiedValues": {
            "MultiAZ": true
        },
        "MultiAZ": false,
        "EngineVersion": "3.3.2",
        "AutoMinorVersionUpgrade": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/f7bc0f8e-1a3a-4ace-9faa-e8494fa3921a",

        ...output omitted...

    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 복제 인스턴스 작업을 AWS DMS 참조하세요.

다음 코드 예시에서는 modify-replication-subnet-group을 사용하는 방법을 보여 줍니다.

AWS CLI

서브넷 그룹을 수정하려면

다음 modify-replication-subnet-group 예제에서는 서브넷 그룹과 연결된 서브넷 목록을 변경합니다.

aws dms modify-replication-subnet-group \
    --replication-subnet-group-identifier my-subnet-group \
    --subnet-id subnet-da327bf6 subnet-bac383e0

출력:

{
    "ReplicationSubnetGroup": {
        "ReplicationSubnetGroupIdentifier": "my-subnet-group",
        "ReplicationSubnetGroupDescription": "my subnet group",
        "VpcId": "vpc-136a4c6a",
        "SubnetGroupStatus": "Complete",
        "Subnets": [
            {
                "SubnetIdentifier": "subnet-da327bf6",
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1a"
                },
                "SubnetStatus": "Active"
            },
            {
                "SubnetIdentifier": "subnet-bac383e0",
                "SubnetAvailabilityZone": {
                    "Name": "us-east-1c"
                },
                "SubnetStatus": "Active"
            }
        ]
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 복제 인스턴스에 대한 네트워크 설정을 참조하세요.

다음 코드 예시에서는 modify-replication-task을 사용하는 방법을 보여 줍니다.

AWS CLI

복제 작업을 수정하려면

다음 modify-replication-task 예제에서는 태스크의 테이블 매핑을 변경합니다.

aws dms modify-replication-task \
    --replication-task-arn "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" \
    --table-mappings file://table-mappings.json

table-mappings.json의 콘텐츠:

{
    "rules": [
        {
            "rule-type": "selection",
            "rule-id": "1",
            "rule-name": "1",
            "object-locator": {
                "schema-name": "prodrep",
                "table-name": "ACCT_%"
            },
            "rule-action": "include",
            "filters": []
        }
    ]
}

출력:

{
    "ReplicationTask": {
        "ReplicationTaskIdentifier": "moveit2",
        "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "MigrationType": "full-load",
        "TableMappings": ...output omitted...,
        "ReplicationTaskSettings": ...output omitted...,
        "Status": "modifying",
        "StopReason": "Stop Reason FULL_LOAD_ONLY_FINISHED",
        "ReplicationTaskCreationDate": 1590524772.505,
        "ReplicationTaskStartDate": 1590789424.653,
        "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 작업 작업을 AWS DMS 참조하세요.

다음 코드 예시에서는 reboot-replication-instance을 사용하는 방법을 보여 줍니다.

AWS CLI

복제 인스턴스를 재부팅하려면

다음 reboot-replication-instance 예제에서는 복제 인스턴스를 재부팅합니다.

aws dms reboot-replication-instance \
    --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE

출력:

{
    "ReplicationInstance": {
        "ReplicationInstanceIdentifier": "my-repl-instance",
        "ReplicationInstanceClass": "dms.t2.micro",
        "ReplicationInstanceStatus": "rebooting",
        "AllocatedStorage": 5,
        "InstanceCreateTime": 1590011235.952,
    ... output omitted ...
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 복제 인스턴스 작업을 AWS DMS 참조하세요.

다음 코드 예시에서는 refresh-schemas을 사용하는 방법을 보여 줍니다.

AWS CLI

데이터베이스 스키마를 새로 고치려면

다음 refresh-schemas 예제에서는 엔드포인트에서 스키마 목록을 새로 AWS DMS고치는 요청을 요청합니다.

aws dms refresh-schemas \
    --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \
    --endpoint-arn "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA"

출력:

{
    "RefreshSchemasStatus": {
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "Status": "refreshing",
        "LastRefreshDate": 1590019949.103
    }
}

  • 자세한 API 내용은 명령 참조RefreshSchemas의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 reload-tables을 사용하는 방법을 보여 줍니다.

AWS CLI

엔드포인트에서 사용할 수 있는 테이블 목록을 새로 고치려면

다음 reload-tables 예제에서는 엔드포인트에서 사용 가능한 테이블 목록을 다시 로드합니다.

aws dms reload-tables \
    --replication-task-arn "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII" \
    --tables-to-reload "SchemaName=prodrep,TableName=ACCT_BAL"

출력:

{
    "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
}

  • 자세한 API 내용은 명령 참조ReloadTables의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 remove-tags-from-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

복제 인스턴스에서 태그를 제거하려면

다음 remove-tags-from-resource 예제에서는 복제 인스턴스에서 태그를 제거합니다.

aws dms remove-tags-from-resource \
    --resource-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \
    --tag-keys Environment Project

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 리소스 태그 지정을 참조하세요.

다음 코드 예시에서는 start-replication-task-assessment을 사용하는 방법을 보여 줍니다.

AWS CLI

작업 평가를 시작하려면

다음 start-replication-task-assessment 예제에서는 복제 작업 평가를 시작합니다.

aws dms start-replication-task-assessment \
    --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII

출력:

{
    "ReplicationTask": {
        "ReplicationTaskIdentifier": "moveit2",
        "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "MigrationType": "full-load",
        "TableMappings": ...output omitted...,
        "ReplicationTaskSettings": ...output omitted...,
        "Status": "testing",
        "StopReason": "Stop Reason FULL_LOAD_ONLY_FINISHED",
        "ReplicationTaskCreationDate": 1590524772.505,
        "ReplicationTaskStartDate": 1590789988.677,
        "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 작업 평가 보고서 생성을 참조하세요.

다음 코드 예시에서는 start-replication-task을 사용하는 방법을 보여 줍니다.

AWS CLI

복제 작업을 시작하려면

다음 command-name 예제에서는 AWS 계정에서 사용 가능한 위젯을 나열합니다.

aws dms start-replication-task \
    --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII \
    --start-replication-task-type reload-target

출력:

{
    "ReplicationTask": {
        "ReplicationTaskIdentifier": "moveit2",
        "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "MigrationType": "full-load",
        "TableMappings": ...output omitted... ,
        "ReplicationTaskSettings": ...output omitted... ,
        "Status": "starting",
        "ReplicationTaskCreationDate": 1590524772.505,
        "ReplicationTaskStartDate": 1590619805.212,
        "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 작업 작업을 AWS DMS 참조하세요.

다음 코드 예시에서는 stop-replication-task을 사용하는 방법을 보여 줍니다.

AWS CLI

작업을 중지하려면

다음 stop-replication-task 예제는 태스크를 중지합니다.

aws dms stop-replication-task \
    --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII

출력:

{
    "ReplicationTask": {
        "ReplicationTaskIdentifier": "moveit2",
        "SourceEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "TargetEndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U",
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "MigrationType": "full-load",
        "TableMappings": ...output omitted...,
        "ReplicationTaskSettings": ...output omitted...,
        "Status": "stopping",
        "ReplicationTaskCreationDate": 1590524772.505,
        "ReplicationTaskStartDate": 1590789424.653,
        "ReplicationTaskArn": "arn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII"
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 작업 작업을 AWS DMS 참조하세요.

  • 자세한 API 내용은 명령 참조StopReplicationTask의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 test-connection을 사용하는 방법을 보여 줍니다.

AWS CLI

엔드포인트에 대한 연결을 테스트하려면

다음 test-connection 예제에서는 복제 인스턴스에서 엔드포인트에 액세스할 수 있는지 테스트합니다.

aws dms test-connection \
    --replication-instance-arn arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE \
    --endpoint-arn arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA

출력:

{
    "Connection": {
        "ReplicationInstanceArn": "arn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE",
        "EndpointArn": "arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA",
        "Status": "testing",
        "EndpointIdentifier": "src-database-1",
        "ReplicationInstanceIdentifier": "my-repl-instance"
    }
}

자세한 내용은 AWS 데이터베이스 마이그레이션 서비스 사용 설명서의 소스 및 대상 엔드포인트 생성을 참조하세요.

  • 자세한 API 내용은 명령 참조TestConnection의 섹션을 참조하세요. AWS CLI