Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. AWS
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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-arnarn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE\ --tagsKey=Environment,Value=PRODKey=Project,Value=dbMigration이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS Database Migration Service 사용 설명서의 Tagging Resources을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 AddTagsToResource
를 참조하세요.
-
다음 코드 예시는 cancel-metadata-model-conversion의 사용 방법을 보여 줍니다.
- AWS CLI
-
메타데이터 모델 변환을 취소하려면
다음
cancel-metadata-model-conversion예시에서는 메타데이터 모델 변환 작업을 취소합니다.aws dms cancel-metadata-model-conversion \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --request-identifiera1b2c3d4-5678-90ab-cdef-EXAMPLE11111출력:
{ "Request": { "Status": "CANCELING", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" } }자세한 내용은 Database Migration Service 사용 설명서의 데이터베이스 스키마 변환을 참조하세요. AWS
-
API 세부 정보는 명령 참조의 CancelMetadataModelConversion
을 참조하세요. AWS CLI
-
다음 코드 예시는 cancel-metadata-model-creation의 사용 방법을 보여 줍니다.
- AWS CLI
-
메타데이터 모델 생성을 취소하려면
다음
cancel-metadata-model-creation예시에서는 메타데이터 모델 생성 작업을 취소합니다.aws dms cancel-metadata-model-creation \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --request-identifiera1b2c3d4-5678-90ab-cdef-EXAMPLE11111출력:
{ "Request": { "Status": "CANCELING", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" } }자세한 내용은 AWS Database Migration Service 사용 설명서의 명령문 메타데이터 모델 생성을 참조하세요.
-
API 세부 정보는 명령 참조의 CancelMetadataModelCreation
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 create-data-provider의 사용 방법을 보여 줍니다.
- AWS CLI
-
예제 1: Microsoft SQL Server 데이터 공급자 생성
다음
create-data-provider예제에서는 Microsoft SQL Server 데이터 공급자를 생성합니다.aws dms create-data-provider \ --data-provider-nameexample-data-provider\ --enginesqlserver\ --description"Example data provider for documentation"\ --settingsMicrosoftSqlServerSettings={ServerName=example-source-server.us-east-1.rds.amazonaws.com,Port=1433,DatabaseName=ExampleDatabase,SslMode=verify-full,CertificateArn=arn:aws:dms:us-east-1:123456789012:cert:EXAMPLEABCDEFGHIJKLMNOPQRS}출력:
{ "DataProvider": { "DataProviderName": "example-data-provider", "DataProviderArn": "arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS", "DataProviderCreationTime": "2026-01-09T12:30:00.000000+00:00", "Description": "Example data provider for documentation", "Engine": "sqlserver", "Settings": { "MicrosoftSqlServerSettings": { "ServerName": "example-source-server.us-east-1.rds.amazonaws.com", "Port": 1433, "DatabaseName": "ExampleDatabase", "SslMode": "verify-full", "CertificateArn": "arn:aws:dms:us-east-1:123456789012:cert:EXAMPLEABCDEFGHIJKLMNOPQRS" } } } }자세한 내용은 AWS Database Migration Service 사용 설명서의 데이터 공급자 작업을 참조하세요.
예제 2: 가상 데이터 공급자 생성
다음
create-data-provider예제에서는 데이터베이스에 연결할 필요가 없는 가상 데이터 공급자를 생성합니다.aws dms create-data-provider \ --data-provider-nameexample-virtual-data-provider\ --engineaurora-postgresql\ --description"Example data provider for documentation"\ --virtual \ --settingsPostgreSqlSettings={ServerName=virtual,Port=5432,DatabaseName=virtual,SslMode=none}출력:
{ "DataProvider": { "DataProviderName": "example-virtual-data-provider", "DataProviderArn": "arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS", "DataProviderCreationTime": "2026-01-09T12:30:00.000000+00:00", "Description": "Example data provider for documentation", "Engine": "aurora-postgresql", "Virtual": true, "Settings": { "PostgreSqlSettings": { "ServerName": "virtual", "Port": 5432, "DatabaseName": "virtual", "SslMode": "none" } } } }자세한 내용은 AWS Database Migration Service 사용 설명서의 가상 데이터 공급자 작업을 참조하세요.
-
API 세부 정보는 명령 참조의 CreateDataProvider
를 참조하세요. AWS CLI
-
다음 코드 예시는 create-endpoint의 사용 방법을 보여 줍니다.
- AWS CLI
-
엔드포인트 생성
다음
create-endpoint예시에서는 Amazon S3 소스에 대한 엔드포인트를 생성합니다.aws dms create-endpoint \ --endpoint-typesource\ --engine-names3\ --endpoint-identifiersrc-endpoint\ --s3-settingsfile://s3-settings.jsons3-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 Database Migration Service 사용 설명서의 AWS DMS 엔드포인트 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 CreateEndpoint
를 참조하세요.
-
다음 코드 예시에서는 create-event-subscription 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
이벤트 구독을 나열하는 방법
다음
create-event-subscription예시에서는 Amazon SNS 주제(my-sns-topic)에 대한 이벤트 구독을 생성합니다.aws dms create-event-subscription \ --subscription-namemy-dms-events\ --sns-topic-arnarn: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 Database Migration Service 사용 설명서의 Working with Events and Notifications를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 CreateEventSubscription
을 참조하세요.
-
다음 코드 예시는 create-instance-profile의 사용 방법을 보여 줍니다.
- AWS CLI
-
인스턴스 프로파일 생성
다음
create-instance-profile예제에서는 인스턴스 프로파일을 생성합니다.aws dms create-instance-profile \ --instance-profile-nameexample-instance-profile\ --description"Example instance profile for documentation"\ --subnet-group-identifierexample-replication-subnet-group\ --vpc-security-groups"sg-0123456789abcdef0"\ --kms-key-arnarn:aws:kms:us-east-1:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\ --network-typeIPV4\ --no-publicly-accessible출력:
{ "InstanceProfile": { "InstanceProfileArn": "arn:aws:dms:us-east-1:123456789012:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS", "KmsKeyArn": "arn:aws:kms:us-east-1:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "PubliclyAccessible": false, "NetworkType": "IPV4", "InstanceProfileName": "example-instance-profile", "Description": "Example instance profile for documentation", "InstanceProfileCreationTime": "2026-01-09T12:30:00.000000+00:00", "SubnetGroupIdentifier": "example-replication-subnet-group", "VpcSecurityGroups": [ "sg-0123456789abcdef0" ] } }자세한 내용은 AWS Database Migration Service 사용 설명서의 인스턴스 프로파일 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 CreateInstanceProfile
을 참조하세요.
-
다음 코드 예시는 create-migration-project의 사용 방법을 보여 줍니다.
- AWS CLI
-
마이그레이션 프로젝트를 생성하려면
다음
create-migration-project예시에서는 마이그레이션 프로젝트를 생성합니다.aws dms create-migration-project \ --migration-project-nameexample-migration-project\ --description"Example migration project for documentation"\ --source-data-provider-descriptorsDataProviderIdentifier=arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS,SecretsManagerSecretId=arn:aws:secretsmanager:us-east-1:123456789012:secret:example-source-secret-A1B2C3,SecretsManagerAccessRoleArn=arn:aws:iam::123456789012:role/example-secrets-manager-role\ --target-data-provider-descriptorsDataProviderIdentifier=arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS,SecretsManagerSecretId=arn:aws:secretsmanager:us-east-1:123456789012:secret:example-target-secret-A1B2C3,SecretsManagerAccessRoleArn=arn:aws:iam::123456789012:role/example-secrets-manager-role\ --instance-profile-identifierarn:aws:dms:us-east-1:123456789012:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS\ --transformation-rules '{"rules":[{"rule-type":"transformation","rule-id":"1","rule-name":"1","rule-target":"schema","rule-action":"rename","object-locator":{"schema-name":"ExampleSchema"},"value":"TargetSchema"}]}' \ --schema-conversion-application-attributesS3BucketPath=s3://amzn-s3-demo-bucket,S3BucketRoleArn=arn:aws:iam::123456789012:role/example-s3-access-role출력:
{ "MigrationProject": { "MigrationProjectName": "example-migration-project", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "MigrationProjectCreationTime": "2026-01-09T12:30:00.000000+00:00", "SourceDataProviderDescriptors": [ { "SecretsManagerSecretId": "arn:aws:secretsmanager:us-east-1:123456789012:secret:example-source-secret-A1B2C3", "SecretsManagerAccessRoleArn": "arn:aws:iam::123456789012:role/example-secrets-manager-role", "DataProviderName": "example-data-provider", "DataProviderArn": "arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS" } ], "TargetDataProviderDescriptors": [ { "SecretsManagerSecretId": "arn:aws:secretsmanager:us-east-1:123456789012:secret:example-target-secret-A1B2C3", "SecretsManagerAccessRoleArn": "arn:aws:iam::123456789012:role/example-secrets-manager-role", "DataProviderName": "example-data-provider", "DataProviderArn": "arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS" } ], "InstanceProfileArn": "arn:aws:dms:us-east-1:123456789012:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS", "InstanceProfileName": "example-instance-profile", "TransformationRules": "{\"rules\":[{\"rule-type\":\"transformation\",\"rule-id\":\"1\",\"rule-name\":\"1\",\"rule-target\":\"schema\",\"rule-action\":\"rename\",\"object-locator\":{\"schema-name\":\"ExampleSchema\"},\"value\":\"TargetSchema\"}]}", "Description": "Example migration project for documentation", "SchemaConversionApplicationAttributes": { "S3BucketPath": "s3://amzn-s3-demo-bucket", "S3BucketRoleArn": "arn:aws:iam::123456789012:role/example-s3-access-role" } } }자세한 내용은 AWS Database Migration Service 사용 설명서의 마이그레이션 프로젝트 작업을 참조하세요.
-
API 세부 정보는 명령 참조의 CreateMigrationProject
를 참조하세요. AWS CLI
-
다음 코드 예시는 create-replication-instance의 사용 방법을 보여 줍니다.
- AWS CLI
-
복제 인스턴스 생성
다음
create-replication-instance예시에서는 복제 인스턴스를 생성합니다.aws dms create-replication-instance \ --replication-instance-identifiermy-repl-instance\ --replication-instance-classdms.t2.micro\ --allocated-storage5출력:
{ "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 Database Migration Service 사용 설명서의 AWS DMS 복제 인스턴스 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 CreateReplicationInstance
섹션을 참조하세요.
-
다음 코드 예시에서는 create-replication-subnet-group 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
서브넷 그룹 생성
다음
create-replication-subnet-group예시에서는 3개의 서브넷으로 구성된 그룹을 생성합니다.aws dms create-replication-subnet-group \ --replication-subnet-group-identifiermy-subnet-group\ --replication-subnet-group-description"my subnet group"\ --subnet-idssubnet-da327bf6subnet-bac383e0subnet-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 Database Migration Service 사용 설명서의 Setting Up a Network for a Replication Instance를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 CreateReplicationSubnetGroup
을 참조하세요.
-
다음 코드 예시에서는 create-replication-task 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
복제 태스크 생성
다음
create-replication-task예시에서는 복제 태스크를 생성합니다.aws dms create-replication-task \ --replication-task-identifiermovedata\ --source-endpoint-arnarn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA\ --target-endpoint-arnarn:aws:dms:us-east-1:123456789012:endpoint:EOM4SFKCZEYHZBFGAGZT3QEC5U\ --replication-instance-arn$RI_ARN\ --migration-typefull-load\ --table-mappingsfile://table-mappings.jsontable-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 Database Migration Service 사용 설명서의 AWS DMS 작업 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 CreateReplicationTask
를 참조하세요.
-
다음 코드 예시에서는 delete-connection 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
연결 삭제
다음
delete-connection예시에서는 복제 인스턴스에서 엔드포인트의 연결을 해제합니다.aws dms delete-connection \ --endpoint-arnarn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA\ --replication-instance-arnarn: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 Database Migration Service 사용 설명서의 https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.Creating.html 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DeleteConnection
을 참조하세요.
-
다음 코드 예시는 delete-data-provider의 사용 방법을 보여 줍니다.
- AWS CLI
-
데이터 공급자를 삭제하려면
다음
delete-data-provider예시에서는 ARN으로 식별되는 데이터 공급자를 삭제합니다.aws dms delete-data-provider \ --data-provider-identifierarn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS출력:
{ "DataProvider": { "DataProviderName": "example-data-provider", "DataProviderArn": "arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS", "DataProviderCreationTime": "2026-01-09T12:30:00.000000+00:00", "Description": "Example data provider for documentation", "Engine": "sqlserver", "Settings": { "MicrosoftSqlServerSettings": { "ServerName": "example-source-server.us-east-1.rds.amazonaws.com", "Port": 1433, "DatabaseName": "ExampleDatabase", "SslMode": "verify-full", "CertificateArn": "arn:aws:dms:us-east-1:123456789012:cert:EXAMPLEABCDEFGHIJKLMNOPQRS" } } } }자세한 내용은 AWS Database Migration Service 사용 설명서의 데이터 공급자 작업을 참조하세요.
-
API 세부 정보는 명령 참조의 DeleteDataProvider
를 참조하세요. AWS CLI
-
다음 코드 예시는 delete-endpoint의 사용 방법을 보여 줍니다.
- AWS CLI
-
엔드포인트 삭제
다음
delete-endpoint예시에서는 엔드포인트를 삭제합니다.aws dms delete-endpoint \ --endpoint-arnarn: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 Database Migration Service 사용 설명서의 AWS DMS 엔드포인트 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DeleteEndpoint
섹션을 참조하세요.
-
다음 코드 예시에서는 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 Database Migration Service 사용 설명서의 Working with Events and Notifications를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DeleteEventSubscription
을 참조하세요.
-
다음 코드 예시는 delete-instance-profile의 사용 방법을 보여 줍니다.
- AWS CLI
-
인스턴스 프로파일 삭제
다음
delete-instance-profile예시에서는 ARN으로 식별된 인스턴스 프로파일을 삭제합니다.aws dms delete-instance-profile \ --instance-profile-identifierarn:aws:dms:us-east-1:123456789012:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS출력:
{ "InstanceProfile": { "InstanceProfileArn": "arn:aws:dms:us-east-1:123456789012:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS", "KmsKeyArn": "arn:aws:kms:us-east-1:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "PubliclyAccessible": false, "NetworkType": "IPV4", "InstanceProfileName": "example-instance-profile", "Description": "Example instance profile for documentation", "InstanceProfileCreationTime": "2026-01-09T12:30:00.000000+00:00", "SubnetGroupIdentifier": "example-replication-subnet-group", "VpcSecurityGroups": [ "sg-0123456789abcdef0" ] } }자세한 내용은 AWS Database Migration Service 사용 설명서의 인스턴스 프로파일 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DeleteInstanceProfile
을 참조하세요.
-
다음 코드 예시는 delete-migration-project의 사용 방법을 보여 줍니다.
- AWS CLI
-
마이그레이션 프로젝트를 삭제하려면
다음
delete-migration-project예시에서는 ARN으로 식별된 마이그레이션 프로젝트를 삭제합니다.aws dms delete-migration-project \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS출력:
{ "MigrationProject": { "MigrationProjectName": "example-migration-project", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "MigrationProjectCreationTime": "2026-01-09T12:30:00.000000+00:00", "SourceDataProviderDescriptors": [ { "SecretsManagerSecretId": "arn:aws:secretsmanager:us-east-1:123456789012:secret:example-source-secret-A1B2C3", "SecretsManagerAccessRoleArn": "arn:aws:iam::123456789012:role/example-secrets-manager-role", "DataProviderName": "example-data-provider", "DataProviderArn": "arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS" } ], "TargetDataProviderDescriptors": [ { "SecretsManagerSecretId": "arn:aws:secretsmanager:us-east-1:123456789012:secret:example-target-secret-A1B2C3", "SecretsManagerAccessRoleArn": "arn:aws:iam::123456789012:role/example-secrets-manager-role", "DataProviderName": "example-data-provider", "DataProviderArn": "arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS" } ], "InstanceProfileArn": "arn:aws:dms:us-east-1:123456789012:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS", "InstanceProfileName": "example-instance-profile", "TransformationRules": "{\"rules\":[{\"rule-type\":\"transformation\",\"rule-id\":\"1\",\"rule-name\":\"1\",\"rule-target\":\"schema\",\"rule-action\":\"rename\",\"object-locator\":{\"schema-name\":\"ExampleSchema\"},\"value\":\"TargetSchema\"}]}", "Description": "Example migration project for documentation", "SchemaConversionApplicationAttributes": { "S3BucketPath": "s3://amzn-s3-demo-bucket", "S3BucketRoleArn": "arn:aws:iam::123456789012:role/example-s3-access-role" } } }자세한 내용은 AWS Database Migration Service 사용 설명서의 마이그레이션 프로젝트 작업을 참조하세요.
-
API 세부 정보는 명령 참조의 DeleteMigrationProject
를 참조하세요. AWS CLI
-
다음 코드 예시는 delete-replication-instance의 사용 방법을 보여 줍니다.
- AWS CLI
-
복제 인스턴스 삭제
다음
delete-replication-instance예시에서는 복제 인스턴스를 삭제합니다.aws dms delete-replication-instance \ --replication-instance-arnarn: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 Database Migration Service 사용 설명서의 AWS DMS 복제 인스턴스 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DeleteReplicationInstance
를 참조하세요.
-
다음 코드 예시에서는 delete-replication-subnet-group 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
서브넷 그룹 삭제
다음
delete-replication-subnet-group예시에서는 서브넷 그룹을 삭제합니다.aws dms delete-replication-subnet-group \ --replication-subnet-group-identifiermy-subnet-group출력:
(none)자세한 내용은 AWS Database Migration Service 사용 설명서의 Setting Up a Network for a Replication Instance를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DeleteReplicationSubnetGroup
를 참조하세요.
-
다음 코드 예시에서는 delete-replication-task 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
복제 태스크를 삭제하는 방법
다음
delete-replication-task예시에서는 복제 태스크를 삭제합니다.aws dms delete-replication-task \ --replication-task-arnarn: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 Database Migration Service 사용 설명서의 AWS DMS 작업 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DeleteReplicationTask
을 참조하세요.
-
다음 코드 예시에서는 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" }-
API 세부 정보는 AWS CLI 명령 참조의 DescribeAccountAttributes
를 참조하세요.
-
다음 코드 예시에서는 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 Database Migration Service 사용 설명서의 Using SSL을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeCertificates
를 참조하세요.
-
다음 코드 예시에서는 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 Database Migration Servic 사용 설명서의 Creating Source and Target Endpoints를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeConnections
을 참조하세요.
-
다음 코드 예시는 describe-conversion-configuration의 사용 방법을 보여 줍니다.
- AWS CLI
-
변환 구성을 설명하려면
다음
describe-conversion-configuration예제에서는 마이그레이션 프로젝트의 변환 구성을 검색합니다.aws dms describe-conversion-configuration \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS출력:
{ "MigrationProjectIdentifier": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "ConversionConfiguration": "{\"Common project settings\":{\"ShowSeverityLevelInSql\":\"CRITICAL\",\"EnableGenAiConversion\":false},\"MSSQL_TO_AURORA_POSTGRESQL\":{\"ConvertProceduresToFunction\":true,\"UniqueIndexGeneration\":true,\"CaseSensitivityNames\":false},\"Conversion version\":{\"MSSQL_TO_AURORA_POSTGRESQL_target_engine_version\":\"15\"}}" }자세한 내용은 AWS Database Migration Service 사용 설명서의 스키마 변환 설정 지정을 참조하세요.
-
API 세부 정보는 명령 참조의 DescribeConversionConfiguration
을 참조하세요. AWS CLI
-
다음 코드 예시는 describe-data-providers의 사용 방법을 보여 줍니다.
- AWS CLI
-
데이터 공급자를 설명하려면
다음
describe-data-providers예제에서는 ARN으로 식별되는 데이터 공급자의 세부 정보를 검색합니다.aws dms describe-data-providers \ --filtersName=data-provider-identifier,Values=arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS출력:
{ "DataProviders": [ { "DataProviderName": "example-data-provider", "DataProviderArn": "arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS", "DataProviderCreationTime": "2026-01-09T12:30:00.000000+00:00", "Description": "Example data provider for documentation", "Engine": "sqlserver", "Settings": { "MicrosoftSqlServerSettings": { "ServerName": "example-source-server.us-east-1.rds.amazonaws.com", "Port": 1433, "DatabaseName": "ExampleDatabase", "SslMode": "verify-full", "CertificateArn": "arn:aws:dms:us-east-1:123456789012:cert:EXAMPLEABCDEFGHIJKLMNOPQRS" } } } ] }자세한 내용은 AWS Database Migration Service 사용 설명서의 데이터 공급자 작업을 참조하세요.
-
API 세부 정보는 명령 참조의 DescribeDataProviders
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 describe-endpoint-types의 사용 방법을 보여 줍니다.
- AWS CLI
-
사용 가능한 엔드포인트 유형 나열
다음
describe-endpoint-types예시에서는 사용 가능한 MySQL 엔드포인트 유형을 나열합니다.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 Database Migration Service 사용 설명서의 AWS DMS 엔드포인트 <https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.html>`__ 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeEndpointTypes
를 참조하세요.
-
다음 코드 예시에서는 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 Database Migration Service 사용 설명서의 AWS DMS 엔드포인트 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeEndpoints
섹션을 참조하세요.
-
다음 코드 예시에서는 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 Database Migration Service 사용 설명서의 Working with Events and Notifications를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeEventCategories
를 참조하세요.
-
다음 코드 예시에서는 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 Database Migration Service 사용 설명서의 Working with Events and Notifications를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeEventSubscriptions
를 참조하세요.
-
다음 코드 예시에서는 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 Database Migration Service 사용 설명서의 Working with Events and Notifications를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeEvents
섹션을 참조하세요.
-
다음 코드 예시는 describe-extension-pack-associations의 사용 방법을 보여 줍니다.
- AWS CLI
-
확장 팩 연결을 설명하려면
다음
describe-extension-pack-associations예제에서는 요청 IDs로 식별되는 대상 데이터베이스에 확장 팩을 적용하는 작업의 상태를 검색합니다.aws dms describe-extension-pack-associations \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --filtersName=request-id,Values=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111,a1b2c3d4-5678-90ab-cdef-EXAMPLE22222,a1b2c3d4-5678-90ab-cdef-EXAMPLE33333출력:
{ "Requests": [ { "Status": "SUCCESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" }, { "Status": "IN_PROGRESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "Progress": { "ProgressPercent": 50.0, "ProgressStep": "IN_PROGRESS" } }, { "Status": "FAILED", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "Error": { "defaultErrorDetails": { "Message": "The database user in your target secret does not have sufficient privileges. Grant the required privileges and try again." } } } ] }자세한 내용은 AWS Database Migration Service 사용 설명서의 확장 팩 사용을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeExtensionPackAssociations
섹션을 참조하세요.
-
다음 코드 예시는 describe-instance-profiles의 사용 방법을 보여 줍니다.
- AWS CLI
-
인스턴스 프로파일 설명
다음
describe-instance-profiles예제에서는 ARN으로 식별된 인스턴스 프로파일의 세부 정보를 검색합니다.aws dms describe-instance-profiles \ --filtersName=instance-profile-identifier,Values=arn:aws:dms:us-east-1:123456789012:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS출력:
{ "InstanceProfiles": [ { "InstanceProfileArn": "arn:aws:dms:us-east-1:123456789012:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS", "KmsKeyArn": "arn:aws:kms:us-east-1:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "PubliclyAccessible": false, "NetworkType": "IPV4", "InstanceProfileName": "example-instance-profile", "Description": "Example instance profile for documentation", "InstanceProfileCreationTime": "2026-01-09T12:30:00.000000+00:00", "SubnetGroupIdentifier": "example-replication-subnet-group", "VpcSecurityGroups": [ "sg-0123456789abcdef0" ] } ] }자세한 내용은 AWS Database Migration Service 사용 설명서의 인스턴스 프로파일 작업을 참조하세요.
-
API 세부 정보는 명령 참조의 DescribeInstanceProfiles
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 describe-metadata-model-assessments의 사용 방법을 보여 줍니다.
- AWS CLI
-
메타데이터 모델 평가를 설명하려면
다음
describe-metadata-model-assessments예제에서는 요청 IDs로 식별되는 메타데이터 모델 평가 작업의 상태를 검색합니다.aws dms describe-metadata-model-assessments \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --filtersName=request-id,Values=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111,a1b2c3d4-5678-90ab-cdef-EXAMPLE22222,a1b2c3d4-5678-90ab-cdef-EXAMPLE33333출력:
{ "Requests": [ { "Status": "SUCCESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" }, { "Status": "IN_PROGRESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "Progress": { "ProgressPercent": 50.0, "TotalObjects": 100, "ProgressStep": "ANALYZING", "ProcessedObject": { "Name": "ExampleTable", "Type": "table", "EndpointType": "SOURCE" } } }, { "Status": "FAILED", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "Error": { "defaultErrorDetails": { "Message": "No objects were found according to the specified selection rules. Please review your selection rules and try again." } } } ] }자세한 내용은 Database Migration Service 사용 설명서의 데이터베이스 마이그레이션 평가 보고서 생성을 참조하세요. AWS
-
API 세부 정보는 명령 참조의 DescribeMetadataModelAssessments
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 describe-metadata-model-children의 사용 방법을 보여 줍니다.
- AWS CLI
-
메타데이터 모델 하위 항목 설명
다음
describe-metadata-model-children예시에서는 소스 메타데이터 트리에서ExampleSchema스키마의 하위 메타데이터 모델을 검색합니다.aws dms describe-metadata-model-children \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --selection-rules '{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema"}, "rule-action": "explicit"}]}' \ --originSOURCE출력:
{ "MetadataModelChildren": [ { "MetadataModelName": "Tables", "SelectionRules": "{\"rules\": [{\"rule-type\": \"selection\", \"rule-id\": \"1\", \"rule-name\": \"1\", \"object-locator\": {\"server-name\": \"example-source-server.us-east-1.rds.amazonaws.com\", \"schema-name\": \"ExampleSchema\", \"category-name\": \"Tables\"}, \"rule-action\": \"explicit\"}]}" }, { "MetadataModelName": "Views", "SelectionRules": "{\"rules\": [{\"rule-type\": \"selection\", \"rule-id\": \"2\", \"rule-name\": \"2\", \"object-locator\": {\"server-name\": \"example-source-server.us-east-1.rds.amazonaws.com\", \"schema-name\": \"ExampleSchema\", \"category-name\": \"Views\"}, \"rule-action\": \"explicit\"}]}" }, { "MetadataModelName": "Functions", "SelectionRules": "{\"rules\": [{\"rule-type\": \"selection\", \"rule-id\": \"3\", \"rule-name\": \"3\", \"object-locator\": {\"server-name\": \"example-source-server.us-east-1.rds.amazonaws.com\", \"schema-name\": \"ExampleSchema\", \"category-name\": \"Functions\"}, \"rule-action\": \"explicit\"}]}" }, { "MetadataModelName": "Sequences", "SelectionRules": "{\"rules\": [{\"rule-type\": \"selection\", \"rule-id\": \"4\", \"rule-name\": \"4\", \"object-locator\": {\"server-name\": \"example-source-server.us-east-1.rds.amazonaws.com\", \"schema-name\": \"ExampleSchema\", \"category-name\": \"Sequences\"}, \"rule-action\": \"explicit\"}]}" } ] }자세한 내용은 AWS Database Migration Service 사용 설명서의 메타데이터 모델 트리 탐색을 참조하세요.
-
API 세부 정보는 명령 참조의 DescribeMetadataModelChildren
을 참조하세요. AWS CLI
-
다음 코드 예시는 describe-metadata-model-conversions의 사용 방법을 보여 줍니다.
- AWS CLI
-
메타데이터 모델 변환을 설명하려면
다음
describe-metadata-model-conversions예제에서는 요청 IDs로 식별되는 메타데이터 모델 변환 작업의 상태를 검색합니다.aws dms describe-metadata-model-conversions \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --filtersName=request-id,Values=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111,a1b2c3d4-5678-90ab-cdef-EXAMPLE22222,a1b2c3d4-5678-90ab-cdef-EXAMPLE33333출력:
{ "Requests": [ { "Status": "SUCCESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" }, { "Status": "IN_PROGRESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "Progress": { "ProgressPercent": 50.0, "TotalObjects": 100, "ProgressStep": "CONVERTING", "ProcessedObject": { "Name": "ExampleTable", "Type": "table", "EndpointType": "SOURCE" } } }, { "Status": "FAILED", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "Error": { "defaultErrorDetails": { "Message": "No objects were found according to the specified selection rules. Please review your selection rules and try again." } } } ] }자세한 내용은 Database Migration Service 사용 설명서의 데이터베이스 스키마 변환을 참조하세요. AWS
-
API 세부 정보는 명령 참조의 DescribeMetadataModelConversions
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 describe-metadata-model-creations의 사용 방법을 보여 줍니다.
- AWS CLI
-
메타데이터 모델 생성 설명
다음
describe-metadata-model-creations예제에서는 요청 IDs로 식별되는 메타데이터 모델 생성 작업의 상태를 검색합니다.aws dms describe-metadata-model-creations \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --filtersName=request-id,Values=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111,a1b2c3d4-5678-90ab-cdef-EXAMPLE22222,a1b2c3d4-5678-90ab-cdef-EXAMPLE33333출력:
{ "Requests": [ { "Status": "SUCCESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" }, { "Status": "IN_PROGRESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" }, { "Status": "FAILED", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "Error": { "defaultErrorDetails": { "Message": "No objects were found according to the specified selection rules. Please review your selection rules and try again." } } } ] }자세한 내용은 AWS Database Migration Service 사용 설명서의 명령문 메타데이터 모델 생성을 참조하세요.
-
API 세부 정보는 명령 참조의 DescribeMetadataModelCreations
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 describe-metadata-model-exports-as-script의 사용 방법을 보여 줍니다.
- AWS CLI
-
메타데이터 모델 내보내기를 스크립트로 설명하려면
다음
describe-metadata-model-exports-as-script예제에서는 메타데이터 모델을 요청 IDs로 식별되는 데이터 정의 언어(DDL) 스크립트로 내보내는 작업의 상태를 검색합니다.aws dms describe-metadata-model-exports-as-script \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --filtersName=request-id,Values=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111,a1b2c3d4-5678-90ab-cdef-EXAMPLE22222,a1b2c3d4-5678-90ab-cdef-EXAMPLE33333출력:
{ "Requests": [ { "Status": "SUCCESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "ExportSqlDetails": { "S3ObjectKey": "s3://amzn-s3-demo-bucket/example-migration-project/ExampleScript.zip", "ObjectURL": "https://amzn-s3-demo-bucket.s3.us-east-1.amazonaws.com/example-migration-project/ExampleScript.zip" } }, { "Status": "IN_PROGRESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "Progress": { "ProgressPercent": 50.0, "TotalObjects": 100, "ProgressStep": "IN_PROGRESS", "ProcessedObject": { "EndpointType": "TARGET" } } }, { "Status": "FAILED", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "Error": { "defaultErrorDetails": { "Message": "No objects were found according to the specified selection rules. Please review your selection rules and try again." } } } ] }자세한 내용은 AWS Database Migration Service 사용 설명서의 변환된 코드를 SQL 파일로 저장을 참조하세요.
-
API 세부 정보는 명령 참조의 DescribeMetadataModelExportsAsScript
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 describe-metadata-model-exports-to-target의 사용 방법을 보여 줍니다.
- AWS CLI
-
대상으로 메타데이터 모델 내보내기 설명
다음
describe-metadata-model-exports-to-target예제에서는 변환된 메타데이터 모델을 요청 IDs로 식별되는 대상 데이터베이스로 내보내는 작업의 상태를 검색합니다.aws dms describe-metadata-model-exports-to-target \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --filtersName=request-id,Values=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111,a1b2c3d4-5678-90ab-cdef-EXAMPLE22222,a1b2c3d4-5678-90ab-cdef-EXAMPLE33333출력:
{ "Requests": [ { "Status": "SUCCESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" }, { "Status": "IN_PROGRESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "Progress": { "ProgressPercent": 50.0, "TotalObjects": 100, "ProgressStep": "APPLYING", "ProcessedObject": { "EndpointType": "TARGET" } } }, { "Status": "FAILED", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "Error": { "defaultErrorDetails": { "Message": "No objects were found according to the specified selection rules. Please review your selection rules and try again." } } } ] }자세한 내용은 AWS Database Migration Service 사용 설명서의 변환된 코드 적용을 참조하세요.
-
API 세부 정보는 명령 참조의 DescribeMetadataModelExportsToTarget
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 describe-metadata-model-imports의 사용 방법을 보여 줍니다.
- AWS CLI
-
메타데이터 모델 가져오기를 설명하려면
다음
describe-metadata-model-imports예제에서는 요청 IDs로 식별되는 메타데이터 가져오기 작업의 상태를 검색합니다.aws dms describe-metadata-model-imports \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --filtersName=request-id,Values=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111,a1b2c3d4-5678-90ab-cdef-EXAMPLE22222,a1b2c3d4-5678-90ab-cdef-EXAMPLE33333출력:
{ "Requests": [ { "Status": "SUCCESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" }, { "Status": "IN_PROGRESS", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "Progress": { "ProgressPercent": 50.0, "TotalObjects": 100, "ProgressStep": "IN_PROGRESS", "ProcessedObject": { "EndpointType": "SOURCE" } } }, { "Status": "FAILED", "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "Error": { "defaultErrorDetails": { "Message": "No objects were found according to the specified selection rules. Please review your selection rules and try again." } } } ] }자세한 내용은 AWS Database Migration Service 사용 설명서의 메타데이터 모델 트리 탐색을 참조하세요.
-
API 세부 정보는 명령 참조의 DescribeMetadataModelImports
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 describe-metadata-model의 사용 방법을 보여 줍니다.
- AWS CLI
-
메타데이터 모델을 설명하려면
다음
describe-metadata-model예제에서는 SQL 정의 및 대상 데이터베이스에서 변환된 해당 메타데이터 모델에 대한 참조를 포함하여 소스 메타데이터 트리에서ExampleSchema스키마의ExampleTable테이블에 대한 자세한 정보를 검색합니다.aws dms describe-metadata-model \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --selection-rules '{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema", "table-name": "ExampleTable"}, "rule-action": "explicit"}]}' \ --originSOURCE출력:
{ "MetadataModelName": "ExampleTable", "MetadataModelType": "table", "TargetMetadataModels": [ { "MetadataModelName": "exampletable", "SelectionRules": "{\"rules\": [{\"rule-type\": \"selection\", \"rule-id\": \"1\", \"rule-name\": \"1\", \"object-locator\": {\"server-name\": \"example-target-server.us-east-1.rds.amazonaws.com\", \"schema-name\": \"exampleschema\", \"table-name\": \"exampletable\"}, \"rule-action\": \"explicit\"}]}" } ], "Definition": "CREATE TABLE ExampleTable (ExampleColumn INTEGER NOT NULL);" }자세한 내용은 AWS Database Migration Service 사용 설명서의 메타데이터 모델 트리 탐색을 참조하세요.
-
API 세부 정보는 명령 참조의 DescribeMetadataModel
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 describe-migration-projects의 사용 방법을 보여 줍니다.
- AWS CLI
-
마이그레이션 프로젝트를 설명하려면
다음
describe-migration-projects예제에서는 ARN으로 식별된 마이그레이션 프로젝트의 세부 정보를 검색합니다.aws dms describe-migration-projects \ --filtersName=migration-project-identifier,Values=arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS출력:
{ "MigrationProjects": [ { "MigrationProjectName": "example-migration-project", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "MigrationProjectCreationTime": "2026-01-09T12:30:00.000000+00:00", "SourceDataProviderDescriptors": [ { "SecretsManagerSecretId": "arn:aws:secretsmanager:us-east-1:123456789012:secret:example-source-secret-A1B2C3", "SecretsManagerAccessRoleArn": "arn:aws:iam::123456789012:role/example-secrets-manager-role", "DataProviderName": "example-data-provider", "DataProviderArn": "arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS" } ], "TargetDataProviderDescriptors": [ { "SecretsManagerSecretId": "arn:aws:secretsmanager:us-east-1:123456789012:secret:example-target-secret-A1B2C3", "SecretsManagerAccessRoleArn": "arn:aws:iam::123456789012:role/example-secrets-manager-role", "DataProviderName": "example-data-provider", "DataProviderArn": "arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS" } ], "InstanceProfileArn": "arn:aws:dms:us-east-1:123456789012:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS", "InstanceProfileName": "example-instance-profile", "TransformationRules": "{\"rules\":[{\"rule-type\":\"transformation\",\"rule-id\":\"1\",\"rule-name\":\"1\",\"rule-target\":\"schema\",\"rule-action\":\"rename\",\"object-locator\":{\"schema-name\":\"ExampleSchema\"},\"value\":\"TargetSchema\"}]}", "Description": "Example migration project for documentation", "SchemaConversionApplicationAttributes": { "S3BucketPath": "s3://amzn-s3-demo-bucket", "S3BucketRoleArn": "arn:aws:iam::123456789012:role/example-s3-access-role" } } ] }자세한 내용은 AWS Database Migration Service 사용 설명서의 마이그레이션 프로젝트 작업을 참조하세요.
-
API 세부 정보는 명령 참조의 DescribeMigrationProjects
섹션을 참조하세요. 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 Database Migration Service 사용 설명서의 AWS DMS 복제 인스턴스 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeOrderableReplicationInstances
를 참조하세요.
-
다음 코드 예시에서는 describe-refresh-schemas-status 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
엔드포인트의 새로 고침 상태를 나열하는 방법
다음
describe-refresh-schemas-status예시에서는 이전 새로 고침 요청의 상태를 반환합니다.aws dms describe-refresh-schemas-status \ --endpoint-arnarn: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 } }-
API 세부 정보는 AWS CLI 명령 참조의 DescribeRefreshSchemasStatus
를 참조하세요.
-
다음 코드 예시에서는 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 Database Migration Service 사용 설명서의 AWS DMS 복제 인스턴스 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeReplicationInstances
를 참조하세요.
-
다음 코드 예시에서는 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 Database Migration Service 사용 설명서의 Setting Up a Network for a Replication Instance를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeReplicationSubnetGroups
를 참조하세요.
-
다음 코드 예시에서는 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 Database Migration Servic 사용 설명서의 Creating a Task Assessment Report를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeReplicationTaskAssessmentResults
를 참조하세요.
-
다음 코드 예시에서는 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 Database Migration Service 사용 설명서의 AWS DMS 작업 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 DescribeReplicationTasks
를 참조하세요.
-
다음 코드 예시는 describe-schemas의 사용 방법을 보여 줍니다.
- AWS CLI
-
데이터베이스 스키마를 설명하는 방법
다음
describe-schemas예시에서는 엔드포인트에서 사용 가능한 테이블을 나열합니다.aws dms describe-schemas \ --endpoint-arn"arn:aws:dms:us-east-1:123456789012:endpoint:6GGI6YPWWGAYUVLKIB732KEVWA"출력:
{ "Schemas": [ "prodrep" ] }자세한 내용은 AWS Database Migration Service 사용 설명서의 주제 제목
을 참조하세요. -
API 세부 정보는 AWS CLI 명령 참조의 DescribeSchemas
를 참조하세요.
-
다음 코드 예시는 export-metadata-model-assessment의 사용 방법을 보여 줍니다.
- AWS CLI
-
변환 평가 보고서를 내보내려면
다음
export-metadata-model-assessment예시에서는ExampleSchema스키마의 모든 객체에 대한 변환 평가 보고서를 내보냅니다.aws dms export-metadata-model-assessment \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --selection-rules '{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema"}, "rule-action": "explicit"}]}' \ --file-nameexample-assessment-report\ --assessment-report-typespdfcsv출력:
{ "PdfReport": { "S3ObjectKey": "example-migration-project/example-assessment-report.pdf", "ObjectURL": "https://amzn-s3-demo-bucket.s3.amazonaws.com/example-migration-project/example-assessment-report.pdf" }, "CsvReport": { "S3ObjectKey": "example-migration-project/example-assessment-report.zip", "ObjectURL": "https://amzn-s3-demo-bucket.s3.amazonaws.com/example-migration-project/example-assessment-report.zip" } }자세한 내용은 Database Migration Service 사용 설명서의 데이터베이스 마이그레이션 평가 보고서 생성을 참조하세요. AWS
-
API 세부 정보는 명령 참조의 ExportMetadataModelAssessment
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 get-target-selection-rules의 사용 방법을 보여 줍니다.
- AWS CLI
-
소스 선택 규칙을 대상 선택 규칙으로 변환하려면
다음
get-target-selection-rules예시에서는ExampleSchema스키마에서ExampleTable테이블을 선택하는 소스 선택 규칙을 변환된 대상을 참조하는 대상 선택 규칙으로 변환합니다.aws dms get-target-selection-rules \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --selection-rules '{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "database-name": "ExampleDatabase", "schema-name": "ExampleSchema", "table-name": "ExampleTable"}, "rule-action": "explicit"}]}'출력:
{ "TargetSelectionRules": "{\"rules\": [{\"rule-type\": \"selection\", \"rule-id\": \"1\", \"rule-name\": \"1\", \"object-locator\": {\"server-name\": \"example-target-server.us-east-1.rds.amazonaws.com\", \"schema-name\": \"exampledatabase_exampleschema\", \"table-name\": \"exampletable\"}, \"rule-action\": \"explicit\"}]}" }자세한 내용은 AWS Database Migration Service 사용 설명서의 선택 규칙 사용을 참조하세요.
-
API 세부 정보는 명령 참조의 GetTargetSelectionRules
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 list-tags-for-resource의 사용 방법을 보여 줍니다.
- AWS CLI
-
리소스에 대한 태그 나열
다음
list-tags-for-resource예시에서는 복제 인스턴스의 태그를 나열합니다.aws dms list-tags-for-resource \ --resource-arnarn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE출력:
{ "TagList": [ { "Key": "Project", "Value": "dbMigration" }, { "Key": "Environment", "Value": "PROD" } ] }자세한 내용은 AWS Database Migration Service 사용 설명서의 Tagging Resources을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 ListTagsForResource
를 참조하세요.
-
다음 코드 예시는 modify-conversion-configuration의 사용 방법을 보여 줍니다.
- AWS CLI
-
변환 구성을 수정하려면
다음
modify-conversion-configuration예제에서는 생성형 AI 지원 변환을 활성화하고 마이그레이션 프로젝트의 변환 경로 설정을 업데이트합니다.aws dms modify-conversion-configuration \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --conversion-configuration '{"Common project settings":{"EnableGenAiConversion":true},"MSSQL_TO_AURORA_POSTGRESQL":{"ConvertProceduresToFunction":false}}'출력:
{ "MigrationProjectIdentifier": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" }자세한 내용은 AWS Database Migration Service 사용 설명서의 스키마 변환 설정 지정을 참조하세요.
-
API 세부 정보는 명령 참조의 ModifyConversionConfiguration
을 참조하세요. AWS CLI
-
다음 코드 예시는 modify-data-provider의 사용 방법을 보여 줍니다.
- AWS CLI
-
데이터 공급자를 수정하려면
다음
modify-data-provider예시에서는 데이터 공급자의 설명과 서버 이름을 업데이트합니다.aws dms modify-data-provider \ --data-provider-identifierarn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS\ --description"Updated data provider description"\ --enginesqlserver\ --settingsMicrosoftSqlServerSettings={ServerName=new-source-server.us-east-1.rds.amazonaws.com}출력:
{ "DataProvider": { "DataProviderName": "example-data-provider", "DataProviderArn": "arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS", "DataProviderCreationTime": "2026-01-09T12:30:00.000000+00:00", "Description": "Updated data provider description", "Engine": "sqlserver", "Settings": { "MicrosoftSqlServerSettings": { "ServerName": "new-source-server.us-east-1.rds.amazonaws.com", "Port": 1433, "DatabaseName": "ExampleDatabase", "SslMode": "verify-full", "CertificateArn": "arn:aws:dms:us-east-1:123456789012:cert:EXAMPLEABCDEFGHIJKLMNOPQRS" } } } }자세한 내용은 AWS Database Migration Service 사용 설명서의 데이터 공급자 작업을 참조하세요.
-
API 세부 정보는 명령 참조의 ModifyDataProvider
를 참조하세요. 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 Database Migration Service 사용 설명서의 AWS DMS 엔드포인트 <https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.html>`__ 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 ModifyEndpoint
를 참조하세요.
-
다음 코드 예시에서는 modify-event-subscription 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
이벤트 구독 수정
다음
modify-event-subscription예시에서는 이벤트 구독의 소스 유형을 변경합니다.aws dms modify-event-subscription \ --subscription-name"my-dms-events"\ --source-typereplication-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 Database Migration Service 사용 설명서의 Working with Events and Notifications를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 ModifyEventSubscription
을 참조하세요.
-
다음 코드 예시는 modify-instance-profile의 사용 방법을 보여 줍니다.
- AWS CLI
-
인스턴스 프로파일을 수정하려면
다음
modify-instance-profile예시에서는 인스턴스 프로파일의 설명과 네트워크 유형을 업데이트합니다.aws dms modify-instance-profile \ --instance-profile-identifierarn:aws:dms:us-east-1:123456789012:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS\ --description"Updated instance profile description"\ --network-typeDUAL출력:
{ "InstanceProfile": { "InstanceProfileArn": "arn:aws:dms:us-east-1:123456789012:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS", "KmsKeyArn": "arn:aws:kms:us-east-1:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "PubliclyAccessible": false, "NetworkType": "DUAL", "InstanceProfileName": "example-instance-profile", "Description": "Updated instance profile description", "InstanceProfileCreationTime": "2026-01-09T12:30:00.000000+00:00", "SubnetGroupIdentifier": "example-replication-subnet-group", "VpcSecurityGroups": [ "sg-0123456789abcdef0" ] } }자세한 내용은 AWS Database Migration Service 사용 설명서의 인스턴스 프로파일 작업을 참조하세요.
-
API 세부 정보는 명령 참조의 ModifyInstanceProfile
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 modify-migration-project의 사용 방법을 보여 줍니다.
- AWS CLI
-
마이그레이션 프로젝트를 수정하려면
다음
modify-migration-project예시에서는 마이그레이션 프로젝트의 소스 데이터 공급자와 설명을 업데이트합니다.aws dms modify-migration-project \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --description"Updated migration project description"\ --source-data-provider-descriptorsDataProviderIdentifier=arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS출력:
{ "MigrationProject": { "MigrationProjectName": "example-migration-project", "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", "MigrationProjectCreationTime": "2026-01-09T12:30:00.000000+00:00", "SourceDataProviderDescriptors": [ { "SecretsManagerSecretId": "arn:aws:secretsmanager:us-east-1:123456789012:secret:example-source-secret-A1B2C3", "SecretsManagerAccessRoleArn": "arn:aws:iam::123456789012:role/example-secrets-manager-role", "DataProviderName": "example-data-provider", "DataProviderArn": "arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS" } ], "TargetDataProviderDescriptors": [ { "SecretsManagerSecretId": "arn:aws:secretsmanager:us-east-1:123456789012:secret:example-target-secret-A1B2C3", "SecretsManagerAccessRoleArn": "arn:aws:iam::123456789012:role/example-secrets-manager-role", "DataProviderName": "example-data-provider", "DataProviderArn": "arn:aws:dms:us-east-1:123456789012:data-provider:EXAMPLEABCDEFGHIJKLMNOPQRS" } ], "InstanceProfileArn": "arn:aws:dms:us-east-1:123456789012:instance-profile:EXAMPLEABCDEFGHIJKLMNOPQRS", "InstanceProfileName": "example-instance-profile", "TransformationRules": "{\"rules\":[{\"rule-type\":\"transformation\",\"rule-id\":\"1\",\"rule-name\":\"1\",\"rule-target\":\"schema\",\"rule-action\":\"rename\",\"object-locator\":{\"schema-name\":\"ExampleSchema\"},\"value\":\"TargetSchema\"}]}", "Description": "Updated migration project description", "SchemaConversionApplicationAttributes": { "S3BucketPath": "s3://amzn-s3-demo-bucket", "S3BucketRoleArn": "arn:aws:iam::123456789012:role/example-s3-access-role" } } }자세한 내용은 AWS Database Migration Service 사용 설명서의 마이그레이션 프로젝트 작업을 참조하세요.
-
API 세부 정보는 명령 참조의 ModifyMigrationProject
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 modify-replication-instance의 사용 방법을 보여 줍니다.
- AWS CLI
-
복제 인스턴스 수정
다음
modify-replication-instance예시에서는 다중 AZ 배포를 사용하도록 복제 인스턴스를 수정합니다.aws dms modify-replication-instance \ --replication-instance-arnarn: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 Database Migration Service 사용 설명서의 AWS DMS 복제 인스턴스 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 ModifyReplicationInstance
을 참조하세요.
-
다음 코드 예시에서는 modify-replication-subnet-group 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
서브넷 그룹 수정
다음
modify-replication-subnet-group예시에서는 서브넷 그룹과 연결된 서브넷 목록을 변경합니다.aws dms modify-replication-subnet-group \ --replication-subnet-group-identifiermy-subnet-group\ --subnet-idsubnet-da327bf6subnet-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 Database Migration Service 사용 설명서의 Setting Up a Network for a Replication Instance를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 ModifyReplicationSubnetGroup
을 참조하세요.
-
다음 코드 예시에서는 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-mappingsfile://table-mappings.jsontable-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 Database Migration Service 사용 설명서의 AWS DMS 작업 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 ModifyReplicationTask
를 참조하세요.
-
다음 코드 예시에서는 reboot-replication-instance 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
복제 인스턴스 재부팅
다음
reboot-replication-instance예제에서는 복제 인스턴스를 재부팅합니다.aws dms reboot-replication-instance \ --replication-instance-arnarn: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 Database Migration Service 사용 설명서의 AWS DMS 복제 인스턴스 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 RebootReplicationInstance
을 참조하세요.
-
다음 코드 예시에서는 refresh-schemas 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
데이터베이스 스키마를 새로 고치려면
다음
refresh-schemas예제에서는 AWS DMS가 엔드포인트에서 스키마 목록을 새로 고치도록 요청합니다.aws dms refresh-schemas \ --replication-instance-arnarn: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 세부 정보는 AWS CLI 명령 참조의 RefreshSchemas
를 참조하세요.
-
다음 코드 예시에서는 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 세부 정보는 AWS CLI 명령 참조의 ReloadTables
를 참조하세요.
-
다음 코드 예시에서는 remove-tags-from-resource 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
복제 인스턴스에서 태그를 제거하는 방법
다음
remove-tags-from-resource예시에서는 복제 인스턴스에서 태그를 제거합니다.aws dms remove-tags-from-resource \ --resource-arnarn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE\ --tag-keysEnvironmentProject이 명령은 출력을 생성하지 않습니다.
자세한 내용은 AWS Database Migration Service 사용 설명서의 Tagging Resources을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 RemoveTagsFromResource
를 참조하세요.
-
다음 코드 예시는 start-extension-pack-association의 사용 방법을 보여 줍니다.
- AWS CLI
-
대상 데이터베이스에 확장 팩을 적용하려면
다음
start-extension-pack-association예시에서는 확장 팩의 애플리케이션을 대상 데이터베이스에 대기열에 추가합니다.aws dms start-extension-pack-association \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS출력:
{ "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }자세한 내용은 AWS Database Migration Service 사용 설명서의 확장 팩 사용을 참조하세요.
-
API 세부 정보는 명령 참조의 StartExtensionPackAssociation
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 start-metadata-model-assessment의 사용 방법을 보여 줍니다.
- AWS CLI
-
스키마의 모든 객체를 평가하려면
다음
start-metadata-model-assessment예시에서는ExampleSchema스키마의 모든 객체에 대한 변환 복잡성 평가를 대기열에 넣습니다.aws dms start-metadata-model-assessment \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --selection-rules '{"rules": [{"rule-type": "selection","rule-id": "1","rule-name": "1","object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema"},"rule-action": "explicit"}]}'출력:
{ "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }자세한 내용은 Database Migration Service 사용 설명서의 데이터베이스 마이그레이션 평가 보고서 생성을 참조하세요. AWS
-
API 세부 정보는 명령 참조의 StartMetadataModelAssessment
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 start-metadata-model-conversion의 사용 방법을 보여 줍니다.
- AWS CLI
-
스키마의 모든 객체를 변환하려면
다음
start-metadata-model-conversion예시에서는ExampleSchema스키마의 모든 객체를 대상 데이터베이스 형식으로 변환하는 대기열을 제공합니다.aws dms start-metadata-model-conversion \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --selection-rules '{"rules": [{"rule-type": "selection","rule-id": "1","rule-name": "1","object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema"},"rule-action": "explicit"}]}'출력:
{ "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }자세한 내용은 Database Migration Service 사용 설명서의 데이터베이스 스키마 변환을 참조하세요. AWS
-
API 세부 정보는 명령 참조의 StartMetadataModelConversion
을 참조하세요. AWS CLI
-
다음 코드 예시는 start-metadata-model-creation의 사용 방법을 보여 줍니다.
- AWS CLI
-
SQL 문에 대한 메타데이터 모델을 생성하려면
다음
start-metadata-model-creation예시에서는 SQL 문에 대한 메타데이터 모델 생성을 대기열에 넣습니다. 선택 규칙은 메타데이터 모델이 배치되는 스키마를 지정하고 후속 작업에 사용할 고유 식별자를--metadata-model-name제공합니다.aws dms start-metadata-model-creation \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --selection-rules '{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "database-name": "ExampleDatabase", "schema-name": "ExampleSchema"}, "rule-action": "explicit"}]}' \ --metadata-model-nameExampleStatement\ --properties StatementProperties={Definition="SELECT * FROM ExampleTable;"}출력:
{ "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }자세한 내용은 AWS Database Migration Service 사용 설명서의 명령문 메타데이터 모델 생성을 참조하세요.
-
API 세부 정보는 명령 참조의 StartMetadataModelCreation
을 참조하세요. AWS CLI
-
다음 코드 예시는 start-metadata-model-export-as-script의 사용 방법을 보여 줍니다.
- AWS CLI
-
변환된 메타데이터 모델을 DDL 스크립트로 내보내려면
다음
start-metadata-model-export-as-script예시에서는ExampleSchema스키마의 모든 객체에 대해 변환된 메타데이터 모델을 데이터 정의 언어(DDL) 스크립트로 마이그레이션 프로젝트와 연결된 Amazon S3 버킷으로 내보내는 대기열에 넣습니다.aws dms start-metadata-model-export-as-script \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --selection-rules '{"rules": [{"rule-type": "selection","rule-id": "1","rule-name": "1","object-locator": {"server-name": "example-target-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema"},"rule-action": "explicit"}]}' \ --originTARGET\ --file-nameExampleScript출력:
{ "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }자세한 내용은 AWS Database Migration Service 사용 설명서의 변환된 코드를 SQL 파일로 저장을 참조하세요.
-
API 세부 정보는 명령 참조의 StartMetadataModelExportAsScript
를 참조하세요. AWS CLI
-
다음 코드 예시는 start-metadata-model-export-to-target의 사용 방법을 보여 줍니다.
- AWS CLI
-
변환된 메타데이터 모델을 대상 데이터베이스로 내보내려면
다음
start-metadata-model-export-to-target예시에서는ExampleSchema스키마의 모든 객체에 대해 변환된 메타데이터 모델을 대상 데이터베이스로 내보내는 대기열에 넣습니다.aws dms start-metadata-model-export-to-target \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --selection-rules '{"rules": [{"rule-type": "selection","rule-id": "1","rule-name": "1","object-locator": {"server-name": "example-target-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema"},"rule-action": "explicit"}]}' \ --overwrite-extension-pack출력:
{ "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }자세한 내용은 AWS Database Migration Service 사용 설명서의 변환된 코드 적용을 참조하세요.
-
API 세부 정보는 명령 참조의 StartMetadataModelExportToTarget
을 참조하세요. AWS CLI
-
다음 코드 예시는 start-metadata-model-import의 사용 방법을 보여 줍니다.
- AWS CLI
-
소스 데이터베이스에서 메타데이터를 가져오려면
다음
start-metadata-model-import예시에서는 소스 데이터베이스에서ExampleSchema스키마의 모든 객체에 대한 메타데이터 가져오기를 대기열에 넣습니다.aws dms start-metadata-model-import \ --migration-project-identifierarn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS\ --selection-rules '{"rules": [{"rule-type": "selection","rule-id": "1","rule-name": "1","object-locator": {"server-name": "example-source-server.us-east-1.rds.amazonaws.com", "schema-name": "ExampleSchema"},"rule-action": "explicit"}]}' \ --originSOURCE\ --no-refresh출력:
{ "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }자세한 내용은 AWS Database Migration Service 사용 설명서의 메타데이터 모델 트리 탐색을 참조하세요.
-
API 세부 정보는 명령 참조의 StartMetadataModelImport
섹션을 참조하세요. AWS CLI
-
다음 코드 예시는 start-replication-task-assessment의 사용 방법을 보여 줍니다.
- AWS CLI
-
태스크 평가를 시작하는 방법
다음
start-replication-task-assessment예시에서는 복제 태스크 평가를 시작합니다.aws dms start-replication-task-assessment \ --replication-task-arnarn: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 Database Migration Servic 사용 설명서의 Creating a Task Assessment Report를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 StartReplicationTaskAssessment
을 참조하세요.
-
다음 코드 예시에서는 start-replication-task 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
복제 태스크 시작
다음
command-name예시에서는 AWS 계정에서 사용 가능한 위젯을 나열합니다.aws dms start-replication-task \ --replication-task-arnarn:aws:dms:us-east-1:123456789012:task:K55IUCGBASJS5VHZJIINA45FII\ --start-replication-task-typereload-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 Database Migration Service 사용 설명서의 AWS DMS 작업 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 StartReplicationTask
을 참조하세요.
-
다음 코드 예시에서는 stop-replication-task 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
작업을 중지하려면
다음
stop-replication-task예시에서는 태스크를 중지합니다.aws dms stop-replication-task \ --replication-task-arnarn: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 Database Migration Service 사용 설명서의 AWS DMS 작업 작업을 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 StopReplicationTask
를 참조하세요.
-
다음 코드 예시에서는 test-connection 코드를 사용하는 방법을 보여줍니다.
- AWS CLI
-
엔드포인트에 대한 연결을 테스트하는 방법
다음
test-connection예시에서는 복제 인스턴스에서 엔드포인트에 액세스할 수 있는지 테스트합니다.aws dms test-connection \ --replication-instance-arnarn:aws:dms:us-east-1:123456789012:rep:T3OM7OUB5NM2LCVZF7JPGJRNUE\ --endpoint-arnarn: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 Database Migration Servic 사용 설명서의 Creating source and target endpoints를 참조하세요.
-
API 세부 정보는 AWS CLI 명령 참조의 TestConnection
을 참조하세요.
-