AWS DMS exemples utilisant AWS CLI - AWS Exemples de code SDK
Actions

D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples GitHub .

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWS DMS exemples utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with AWS DMS.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliseradd-tags-to-resource.

AWS CLI

Pour ajouter des balises à une ressource

L'add-tags-to-resourceexemple suivant ajoute des balises à une instance de réplication.

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

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Marquage des ressources dans le Guide de l'utilisateur du AWS Database Migration Service.

  • Pour plus de détails sur l'API, reportez-vous AddTagsToResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-endpoint.

AWS CLI

Pour créer un point de terminaison

L'create-endpointexemple suivant crée un point de terminaison pour une source Amazon S3.

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

Contenu de s3-settings.json :

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

Sortie :

{
    "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
        }
    }
}

Pour plus d'informations, consultez la section Utilisation des points de terminaison AWS DMS dans le Guide de l'utilisateur du AWS Database Migration Service.

  • Pour plus de détails sur l'API, reportez-vous CreateEndpointà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-event-subscription.

AWS CLI

Pour répertorier les abonnements aux événements

L'create-event-subscriptionexemple suivant crée un abonnement à un événement sur une rubrique 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

Sortie :

{
    "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
    }
}

Pour plus d'informations, consultez la section Utilisation des événements et des notifications dans le Guide de l'utilisateur du Service AWS de migration de base de données.

  • Pour plus de détails sur l'API, reportez-vous CreateEventSubscriptionà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-replication-instance.

AWS CLI

Pour créer une instance de réplication

L'create-replication-instanceexemple suivant crée une instance de réplication.

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

Sortie :

{
    "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
    }
}

Pour plus d'informations, consultez la section Utilisation d'une instance de réplication AWS DMS dans le Guide de l'utilisateur du AWS Database Migration Service.

L'exemple de code suivant montre comment utilisercreate-replication-subnet-group.

AWS CLI

Pour créer un groupe de sous-réseaux

L'create-replication-subnet-groupexemple suivant crée un groupe composé de 3 sous-réseaux.

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

Sortie :

{
    "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"
            }
        ]
    }
}

Pour plus d'informations, consultez la section Configuration d'un réseau pour une instance de réplication dans le Guide AWS de l'utilisateur du Database Migration Service.

L'exemple de code suivant montre comment utilisercreate-replication-task.

AWS CLI

Pour créer une tâche de réplication

L'create-replication-taskexemple suivant crée une tâche de réplication.

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

Contenu de table-mappings.json :

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

Sortie :

{
    "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"
    }
}

Pour plus d'informations, consultez la section Utilisation des tâches AWS DMS dans le Guide de l'utilisateur du Service AWS de migration de base de données.

  • Pour plus de détails sur l'API, reportez-vous CreateReplicationTaskà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-connection.

AWS CLI

Pour supprimer une connexion

L'delete-connectionexemple suivant dissocie un point de terminaison d'une instance de réplication.

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

Sortie :

{
    "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"
    }
}

Pour plus d'informations, consultez https://docs.aws.amazon.com/dms/latest/userguide/CHAP_Endpoints.creating.html dans le Guide de l'utilisateur du Database Migration AWS Service.

  • Pour plus de détails sur l'API, reportez-vous DeleteConnectionà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-endpoint.

AWS CLI

Pour supprimer un point de terminaison

L'delete-endpointexemple suivant supprime un point de terminaison.

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

Sortie :

{
    "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
        }
    }
}

Pour plus d'informations, consultez la section Utilisation des points de terminaison AWS DMS dans le Guide de l'utilisateur du AWS Database Migration Service.

  • Pour plus de détails sur l'API, reportez-vous DeleteEndpointà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-event-subscription.

AWS CLI

Pour supprimer un abonnement à un événement

L'delete-event-subscriptionexemple suivant supprime un abonnement à une rubrique Amazon SNS.

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

Sortie :

{
    "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
    }
}

Pour plus d'informations, consultez la section Utilisation des événements et des notifications dans le Guide de l'utilisateur du Service AWS de migration de base de données.

  • Pour plus de détails sur l'API, reportez-vous DeleteEventSubscriptionà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-replication-instance.

AWS CLI

Pour supprimer une instance de réplication

L'exemple de delete-replication-instance suivant supprime une instance de réplication.

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

Sortie :

{
    "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"
    }
}

Pour plus d'informations, consultez la section Utilisation d'une instance de réplication AWS DMS dans le Guide de l'utilisateur du AWS Database Migration Service.

L'exemple de code suivant montre comment utiliserdelete-replication-subnet-group.

AWS CLI

Pour supprimer un groupe de sous-réseaux

L'delete-replication-subnet-groupexemple suivant supprime un groupe de sous-réseaux.

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

Sortie :

(none)

Pour plus d'informations, consultez la section Configuration d'un réseau pour une instance de réplication dans le Guide AWS de l'utilisateur du Database Migration Service.

L'exemple de code suivant montre comment utiliserdelete-replication-task.

AWS CLI

Pour supprimer une tâche de réplication

L'delete-replication-taskexemple suivant supprime une tâche de réplication.

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

Sortie :

{
    "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"
    }
}

Pour plus d'informations, consultez la section Utilisation des tâches AWS DMS dans le Guide de l'utilisateur du Service AWS de migration de base de données.

  • Pour plus de détails sur l'API, reportez-vous DeleteReplicationTaskà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-account-attributes.

AWS CLI

Pour décrire les attributs du compte

L'describe-account-attributesexemple suivant répertorie les attributs de votre AWS compte.

aws dms describe-account-attributes

Sortie :

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

        ...remaining output omitted...

    ],
    "UniqueAccountIdentifier": "cqahfbfy5xee"
}

L'exemple de code suivant montre comment utiliserdescribe-certificates.

AWS CLI

Pour répertorier les certificats disponibles

L'describe-certificatesexemple suivant répertorie les certificats disponibles dans votre AWS compte.

aws dms describe-certificates

Sortie :

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

            ... remaining output omittted ...

        }
    ]
}

Pour plus d'informations, consultez la section Utilisation du protocole SSL dans le Guide de l'utilisateur du AWS Database Migration Service.

  • Pour plus de détails sur l'API, reportez-vous DescribeCertificatesà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-connections.

AWS CLI

Pour décrire les connexions

L'describe-connectionsexemple suivant répertorie les connexions que vous avez testées entre une instance de réplication et un point de terminaison.

aws dms describe-connections

Sortie :

{
    "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"
        }
    ]
}

Pour plus d'informations, consultez la section Création de points de terminaison source et cible dans le Guide de l'utilisateur du AWS Database Migration Service.

  • Pour plus de détails sur l'API, reportez-vous DescribeConnectionsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-endpoint-types.

AWS CLI

Pour répertorier les types de terminaux disponibles

L'describe-endpoint-typesexemple suivant répertorie les types de points de terminaison MySQL disponibles.

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

Sortie :

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

Pour plus d'informations, consultez la section Working with AWS DMS Endpoints < https://docs.aws.amazon.com/dms/ latest/userguide/CHAP _Endpoints.html>`__ dans le Guide de l'utilisateur du AWS Database Migration Service.

  • Pour plus de détails sur l'API, reportez-vous DescribeEndpointTypesà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-endpoints.

AWS CLI

Pour décrire les points de terminaison

L'describe-endpointsexemple suivant répertorie les points de terminaison de votre AWS compte.

aws dms describe-endpoints

Sortie :

{
    "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
        }
    ]
}

Pour plus d'informations, consultez la section Utilisation des points de terminaison AWS DMS dans le Guide de l'utilisateur du AWS Database Migration Service.

  • Pour plus de détails sur l'API, reportez-vous DescribeEndpointsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-event-categories.

AWS CLI

Pour décrire les catégories d'événements

L'describe-event-categoriesexemple suivant répertorie les catégories d'événements disponibles.

aws dms describe-event-categories

Sortie :

{
    "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"
            ]
        }
    ]
}

Pour plus d'informations, consultez la section Utilisation des événements et des notifications dans le Guide de l'utilisateur du Service AWS de migration de base de données.

  • Pour plus de détails sur l'API, reportez-vous DescribeEventCategoriesà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-event-subscriptions.

AWS CLI

Pour décrire les abonnements aux événements

L'describe-event-subscriptionsexemple suivant répertorie les abonnements aux événements à une rubrique Amazon SNS.

aws dms describe-event-subscriptions

Sortie :

{
    "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
        }
    ]
}

Pour plus d'informations, consultez la section Utilisation des événements et des notifications dans le Guide de l'utilisateur du Service AWS de migration de base de données.

L'exemple de code suivant montre comment utiliserdescribe-events.

AWS CLI

Pour répertorier les événements DMS

L'describe-eventsexemple suivant répertorie les événements issus d'une instance de réplication.

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

Sortie :

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

Pour plus d'informations, consultez la section Utilisation des événements et des notifications dans le Guide de l'utilisateur du Service AWS de migration de base de données.

  • Pour plus de détails sur l'API, reportez-vous DescribeEventsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-orderable-replication-instances.

AWS CLI

Pour décrire les instances de réplication pouvant être commandées

L'describe-orderable-replication-instancesexemple suivant répertorie les types d'instances de réplication que vous pouvez commander.

aws dms describe-orderable-replication-instances

Sortie :

{
    "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...

    }

Pour plus d'informations, consultez la section Utilisation d'une instance de réplication AWS DMS dans le Guide de l'utilisateur du AWS Database Migration Service.

L'exemple de code suivant montre comment utiliserdescribe-refresh-schemas-status.

AWS CLI

Pour répertorier l'état d'actualisation d'un point de terminaison

L'describe-refresh-schemas-statusexemple suivant renvoie le statut d'une demande d'actualisation précédente.

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

Sortie :

{
    "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
    }
}

L'exemple de code suivant montre comment utiliserdescribe-replication-instances.

AWS CLI

Pour décrire les instances de réplication

L'describe-replication-instancesexemple suivant répertorie les instances de réplication de votre AWS compte.

aws dms describe-replication-instances

Sortie :

{
    "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
        }
    ]
}

Pour plus d'informations, consultez la section Utilisation d'une instance de réplication AWS DMS dans le Guide de l'utilisateur du AWS Database Migration Service.

L'exemple de code suivant montre comment utiliserdescribe-replication-subnet-groups.

AWS CLI

Pour afficher les groupes de sous-réseaux disponibles

L'describe-replication-subnet-groupsexemple suivant répertorie les groupes de sous-réseaux disponibles.

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

Sortie :

{
    "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"
                }
            ]
        }
    ]
}

Pour plus d'informations, consultez la section Configuration d'un réseau pour une instance de réplication dans le Guide AWS de l'utilisateur du Database Migration Service.

L'exemple de code suivant montre comment utiliserdescribe-replication-task-assessment-results.

AWS CLI

Pour répertorier les résultats des évaluations des tâches de réplication

L'describe-replication-task-assessment-resultsexemple suivant répertorie les résultats d'une évaluation de tâche précédente.

aws dms describe-replication-task-assessment-results

Sortie :

{
    "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"
        }
    ]
}

Pour plus d'informations, consultez la section Création d'un rapport d'évaluation des tâches dans le Guide de l'utilisateur du AWS Database Migration Service.

L'exemple de code suivant montre comment utiliserdescribe-replication-tasks.

AWS CLI

Pour décrire une tâche de réplication

L'describe-replication-tasksexemple suivant décrit les tâches de réplication en cours.

aws dms describe-replication-tasks

Sortie :

{
    "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
            }
        }
    ]
}

Pour plus d'informations, consultez la section Utilisation des tâches AWS DMS dans le Guide de l'utilisateur du Service AWS de migration de base de données.

  • Pour plus de détails sur l'API, reportez-vous DescribeReplicationTasksà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-schemas.

AWS CLI

Pour décrire les schémas de base de données

L'describe-schemasexemple suivant répertorie les tables disponibles sur un point de terminaison.

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

Sortie :

{
    "Schemas": [
        "prodrep"
    ]
}

Pour plus d'informations, voir Ceci est le titre de la rubrique du Guide de l'utilisateur du Service AWS de Migration de Base de Données.

  • Pour plus de détails sur l'API, reportez-vous DescribeSchemasà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-tags-for-resource.

AWS CLI

Pour répertorier les balises d'une ressource

L'list-tags-for-resourceexemple suivant répertorie les balises d'une instance de réplication.

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

Sortie :

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

Pour plus d'informations, consultez la section Marquage des ressources dans le Guide de l'utilisateur du AWS Database Migration Service.

  • Pour plus de détails sur l'API, reportez-vous ListTagsForResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisermodify-endpoint.

AWS CLI

Pour modifier un point de terminaison

L'modify-endpointexemple suivant ajoute un attribut de connexion supplémentaire à un point de terminaison.

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

Sortie :

{
    "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
        }
    }
}

Pour plus d'informations, consultez la section Working with AWS DMS Endpoints < https://docs.aws.amazon.com/dms/ latest/userguide/CHAP _Endpoints.html>`__ dans le Guide de l'utilisateur du AWS Database Migration Service.

  • Pour plus de détails sur l'API, reportez-vous ModifyEndpointà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisermodify-event-subscription.

AWS CLI

Pour modifier l'abonnement à un événement

L'modify-event-subscriptionexemple suivant modifie le type de source d'un abonnement à un événement.

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

Sortie :

{
    "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
    }
}

Pour plus d'informations, consultez la section Utilisation des événements et des notifications dans le Guide de l'utilisateur du Service AWS de migration de base de données.

  • Pour plus de détails sur l'API, reportez-vous ModifyEventSubscriptionà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisermodify-replication-instance.

AWS CLI

Pour modifier une instance de réplication

L'modify-replication-instanceexemple suivant modifie une instance de réplication afin qu'elle utilise un déploiement multi-AZ.

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

Sortie :

{
    "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...

    }
}

Pour plus d'informations, consultez la section Utilisation d'une instance de réplication AWS DMS dans le Guide de l'utilisateur du AWS Database Migration Service.

L'exemple de code suivant montre comment utilisermodify-replication-subnet-group.

AWS CLI

Pour modifier un groupe de sous-réseaux

L'modify-replication-subnet-groupexemple suivant modifie les listes de sous-réseaux associées à un groupe de sous-réseaux.

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

Sortie :

{
    "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"
            }
        ]
    }
}

Pour plus d'informations, consultez la section Configuration d'un réseau pour une instance de réplication dans le Guide AWS de l'utilisateur du Database Migration Service.

L'exemple de code suivant montre comment utilisermodify-replication-task.

AWS CLI

Pour modifier une tâche de réplication

L'modify-replication-taskexemple suivant modifie les mappages de tables pour une tâche.

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

Contenu de 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": []
        }
    ]
}

Sortie :

{
    "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"
    }
}

Pour plus d'informations, consultez la section Utilisation des tâches AWS DMS dans le Guide de l'utilisateur du Service AWS de migration de base de données.

  • Pour plus de détails sur l'API, reportez-vous ModifyReplicationTaskà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserreboot-replication-instance.

AWS CLI

Pour redémarrer une instance de réplication

L'exemple de reboot-replication-instance suivant redémarre une instance de réplication.

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

Sortie :

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

Pour plus d'informations, consultez la section Utilisation d'une instance de réplication AWS DMS dans le Guide de l'utilisateur du AWS Database Migration Service.

L'exemple de code suivant montre comment utiliserrefresh-schemas.

AWS CLI

Pour actualiser les schémas de base de données

L'refresh-schemasexemple suivant demande à AWS DMS d'actualiser la liste des schémas d'un point de terminaison.

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"

Sortie :

{
    "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
    }
}

  • Pour plus de détails sur l'API, reportez-vous RefreshSchemasà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserreload-tables.

AWS CLI

Pour actualiser la liste des tables disponibles sur un point de terminaison

L'reload-tablesexemple suivant recharge la liste des tables disponibles sur un point de terminaison.

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

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous ReloadTablesà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserremove-tags-from-resource.

AWS CLI

Pour supprimer des balises d'une instance de réplication

L'remove-tags-from-resourceexemple suivant supprime les balises d'une instance de réplication.

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

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Marquage des ressources dans le Guide de l'utilisateur du AWS Database Migration Service.

  • Pour plus de détails sur l'API, reportez-vous RemoveTagsFromResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserstart-replication-task-assessment.

AWS CLI

Pour démarrer une évaluation des tâches

L'start-replication-task-assessmentexemple suivant lance une évaluation des tâches de réplication.

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

Sortie :

{
    "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"
    }
}

Pour plus d'informations, consultez la section Création d'un rapport d'évaluation des tâches dans le Guide de l'utilisateur du AWS Database Migration Service.

L'exemple de code suivant montre comment utiliserstart-replication-task.

AWS CLI

Pour démarrer une tâche de réplication

L'command-nameexemple suivant répertorie les widgets disponibles dans votre AWS compte.

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

Sortie :

{
    "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"
    }
}

Pour plus d'informations, consultez la section Utilisation des tâches AWS DMS dans le Guide de l'utilisateur du Service AWS de migration de base de données.

  • Pour plus de détails sur l'API, reportez-vous StartReplicationTaskà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserstop-replication-task.

AWS CLI

Pour arrêter une tâche

L'stop-replication-taskexemple suivant arrête une tâche.

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

Sortie :

{
    "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"
    }
}

Pour plus d'informations, consultez la section Utilisation des tâches AWS DMS dans le Guide de l'utilisateur du Service AWS de migration de base de données.

  • Pour plus de détails sur l'API, reportez-vous StopReplicationTaskà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisertest-connection.

AWS CLI

Pour tester une connexion à un point de terminaison

L'test-connectionexemple suivant teste si un point de terminaison est accessible depuis une instance de réplication.

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

Sortie :

{
    "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"
    }
}

Pour plus d'informations, consultez la section Création de points de terminaison source et cible dans le Guide de l'utilisateur du AWS Database Migration Service.

  • Pour plus de détails sur l'API, reportez-vous TestConnectionà la section Référence des AWS CLI commandes.