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.

Utilisation d’Amazon Timestream comme cible pour AWS Database Migration Service

Vous pouvez utiliser AWS Database Migration Service pour migrer les données de votre base de données source vers un point de terminaison cible Amazon Timestream, en prenant en charge les migrations à chargement complet et CDC.

Amazon Timestream est un service de base de données de séries temporelles rapide, évolutif et sans serveur, conçu pour l’ingestion de grands volumes de données. Les données de séries temporelles sont une séquence de points de données collectés pendant un intervalle de temps et utilisés pour mesurer des événements qui évoluent au fil du temps. Il est utilisé pour collecter, stocker et analyser les métriques des applications IoT, des DevOps applications et des applications d'analyse. Une fois que vous avez enregistré vos données dans Timestream, vous pouvez visualiser et identifier des tendances et des modèles dans vos données en temps quasi réel. Pour plus d’informations sur Amazon Timestream, consultez Qu’est-ce qu’Amazon Timestream ? dans le Guide du développeur Amazon Timestream.

Conditions préalables à l’utilisation d’Amazon Timestream comme cible pour AWS Database Migration Service

Avant de configurer Amazon Timestream comme cible pour AWS DMS, veillez à créer un rôle IAM. Ce rôle doit permettre à AWS DMS d’accéder aux données en cours de migration vers Amazon Timestream. L’ensemble d’autorisations d’accès minimum pour le rôle que vous utilisez pour migrer vers Timestream figure dans la politique IAM suivante.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowDescribeEndpoints",
            "Effect": "Allow",
            "Action": [
                "timestream:DescribeEndpoints"
            ],
            "Resource": "*"
        },
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "timestream:ListTables",
                "timestream:DescribeDatabase"
            ],
            "Resource": "arn:aws:timestream:region:account_id:database/DATABASE_NAME"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": [
                "timestream:DeleteTable",
                "timestream:WriteRecords",
                "timestream:UpdateTable",
                "timestream:CreateTable"
            ],
            "Resource": "arn:aws:timestream:region:account_id:database/DATABASE_NAME/table/TABLE_NAME"
        }
    ]
} 
        

Si vous avez l’intention de migrer toutes les tables, utilisez * pour TABLE_NAME dans l’exemple ci-dessus.

Notez ce qui suit à propos de l’utilisation de Timestream comme cible :

Paramètres de tâche de chargement complet multithread

Pour accélérer le transfert de données, AWS DMS prend en charge une tâche de chargement complet multithread vers un point de terminaison cible Timestream avec les paramètres de tâche suivants :

Paramètres de tâche de chargement CDC multithread

Pour accroître les performances de la fonctionnalité CDC, AWS DMS prend en charge les paramètres de tâche suivants :

Paramètres de point de terminaison lors de l’utilisation de Timestream comme cible pour AWS DMS

Vous pouvez utiliser des paramètres de point de terminaison pour configurer votre base de données Timestream cible comme si vous utilisiez des attributs de connexion supplémentaires. Vous spécifiez les paramètres lorsque vous créez le point de terminaison cible à l'aide de la console AWS DMS ou à l'aide de la commande create-endpoint dans AWS CLI, avec la syntaxe JSON --timestream-settings '{"EndpointSetting": "value", ...}'.

Les paramètres de point de terminaison que vous pouvez utiliser avec Timestream comme cible sont indiqués dans le tableau suivant.

Création et modification d’un point de terminaison Amazon Timestream cible

Une fois que vous avez créé un rôle IAM et défini l’ensemble d’autorisations d’accès minimum, vous pouvez créer un point de terminaison Amazon Timestream cible à l’aide de la console AWS DMS ou de la commande create-endpoint d’AWS CLI, avec la syntaxe JSON --timestream-settings '{"EndpointSetting": "value", ...}'.

Les exemples suivants montrent comment créer et modifier un point de terminaison Timestream cible à l’aide d’AWS CLI.

Commande de création d’un point de terminaison Timestream cible

aws dms create-endpoint —endpoint-identifier timestream-target-demo
--endpoint-type target —engine-name timestream
--service-access-role-arn arn:aws:iam::123456789012:role/my-role
--timestream-settings
{
    "MemoryDuration": 20,
    "DatabaseName":"db_name",
    "MagneticDuration": 3,
    "CdcInsertsAndUpdates": true,
    "EnableMagneticStoreWrites": true,
}

Commande de modification d’un point de terminaison Timestream cible

aws dms modify-endpoint —endpoint-identifier timestream-target-demo
--endpoint-type target —engine-name timestream
--service-access-role-arn arn:aws:iam::123456789012:role/my-role
--timestream-settings
{
    "MemoryDuration": 20,
    "MagneticDuration": 3,
}

Utilisation du mappage d’objet pour migrer des données vers une rubrique Timestream

AWS DMS utilise les règles de mappage de table pour mapper les données de la source à la rubrique Timestream cible. Pour mapper des données à une rubrique cible, vous utilisez un type de règle de mappage de table appelé « mappage d'objet ». Vous utilisez le mappage d’objet pour définir la façon dont les enregistrements de données de la source sont mappés aux enregistrements de données publiés dans une rubrique Timestream.

Les rubriques Timestream ne disposent pas d’une structure prédéfinie autre que le fait d’avoir une clé de partition.

Pour créer une règle de mappage d'objet, spécifiez rule-type comme object-mapping. Cette règle spécifie le type de mappage d'objet que vous souhaitez utiliser. La structure de la règle est la suivante.

{
    "rules": [
        {
            "rule-type": "object-mapping",
            "rule-id": "id",
            "rule-name": "name",
            "rule-action": "valid object-mapping rule action",
            "object-locator": {
                "schema-name": "case-sensitive schema name",
                "table-name": ""
            }
        }
    ]
}

{
    "rules": [
        {
            "rule-type": "object-mapping",
            "rule-id": "1",
            "rule-name": "timestream-map",
            "rule-action": "map-record-to-record",
            "target-table-name": "tablename",
            "object-locator": {
                "schema-name": "",
                "table-name": ""
            },
            "mapping-parameters": {
                "timestream-dimensions": [
                    "column_name1",
                     "column_name2"
                ],
                "timestream-timestamp-name": "time_column_name",
                "timestream-multi-measure-name": "column_name1or2",
                "timestream-hash-measure-name":  true or false,
                "timestream-memory-duration": x,
                "timestream-magnetic-duration": y
            }
        }
    ]
}
    

AWS DMS prend actuellement en charge map-record-to-record et map-record-to-document comme les seules valeurs valides pour le paramètre rule-action. Les valeurs map-record-to-record et map-record-to-document spécifient l'action par défaut d'AWS DMS sur les enregistrements qui ne sont pas exclus en raison de leur appartenance à la liste des attributs exclude-columns. Ces valeurs n'affectent en aucune façon les mappages d'attributs.

Utilisez map-record-to-record lorsque vous migrez une base de données relationnelle vers une rubrique Timestream. Ce type de règle utilise la valeur taskResourceId.schemaName.tableName de la base de données relationnelle comme clé de partition dans la rubrique Timestream, et crée un attribut pour chaque colonne de la base de données source. Lorsque vous utilisez map-record-to-record, pour toute colonne de la table source non répertoriée dans la liste d’attributs exclude-columns, AWS DMS crée un attribut correspondant dans la rubrique cible. Cet attribut correspondant est créé que la colonne source soit ou non utilisée dans un mappage d'attribut.

Une manière de comprendre map-record-to-record est de le voir en action. Dans cet exemple, imaginons que vous commencez avec une ligne de table d'une base de données relationnelle, présentant la structure et les données suivantes :

Pour migrer ces informations à partir d’un schéma nommé Test vers une rubrique Timestream, vous créez des règles pour mapper les données à la rubrique cible. La règle suivante illustre ce mappage.

{
    "rules": [
        {
            "rule-type": "selection",
            "rule-id": "1",
            "rule-name": "1",
            "rule-action": "include",
            "object-locator": {
                "schema-name": "Test",
                "table-name": "%"
            }
        },
        {
            "rule-type": "object-mapping",
            "rule-id": "2",
            "rule-name": "DefaultMapToTimestream",
            "rule-action": "map-record-to-record",
            "object-locator": {
                "schema-name": "Test",
                "table-name": "Customers"
            }
        }
    ]
}

L’exemple ci-dessous illustre le format d’enregistrement obtenu avec une rubrique Timestream et une clé de partition (en l’occurrence, taskResourceId.schemaName.tableName) à l’aide de notre exemple de données dans la rubrique Timestream cible :

  {
     "FirstName": "Randy",
     "LastName": "Marsh",
     "StoreId":  "5",
     "HomeAddress": "221B Baker Street",
     "HomePhone": "1234567890",
     "WorkAddress": "31 Spooner Street, Quahog",
     "WorkPhone": "9876543210",
     "DateOfBirth": "02/29/1988"
  }              

Limites d’utilisation d’Amazon Timestream comme cible pour AWS Database Migration Service

Les limites suivantes s’appliquent lorsque vous utilisez Amazon Timestream comme cible :