As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Utilizar o Amazon Timestream como destino para o AWS Database Migration Service

Você pode usar o AWS Database Migration Service para migrar dados do banco de dados de origem para um endpoint de destino do Amazon Timestream, que aceita migrações de dados de carregamento completo e de CDC.

O Amazon Timestream é um serviço de banco de dados de séries temporais rápido, escalável e sem servidor criado para ingestão de dados de alto volume. Dados de séries temporais são uma sequência de pontos de dados coletados em um intervalo de tempo; eles são usados para medir eventos que mudam com o tempo. Ele é usado para coletar, armazenar e analisar métricas de aplicativos, DevOps aplicativos e aplicativos de análise de IoT. Assim que seus dados estiverem no Timestream, você poderá visualizar e identificar tendências e padrões nesses dados quase em tempo real. Para obter mais informações sobre o Amazon Timestream, consulte What is Amazon Timestream? no Guia do desenvolvedor do Amazon Timestream.

Pré-requisitos para usar o Amazon Timestream como destino para o AWS Database Migration Service

Antes de configurar o Amazon Timestream como destino para o AWS DMS, você deve criar um perfil do IAM. Esse perfil deve permitir que o AWS DMS tenha acesso aos dados que estão sendo migrados para o Amazon Timestream. O conjunto mínimo de permissões de acesso para o perfil que você usa para migrar para o Timestream é mostrado na política do IAM a seguir.

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

Se você pretende migrar todas as tabelas, use * para TABLE_NAME no exemplo acima.

Observe o seguinte sobre o uso do Timestream como destino:

Configurações da tarefa de carga máxima com vários threads

Para ajudar a aumentar a velocidade da transferência de dados, o AWS DMS comporta a tarefa de migração de carga máxima com vários threads para um endpoint de destino do Timestream com estas configurações:

Configurações da tarefa de carga de CDC multithread

Para promover o desempenho da CDC, o AWS DMS oferece suporte a estas configurações de tarefa:

Configurações de endpoint ao usar o Timestream como um destino para o AWS DMS

É possível utilizar as configurações de endpoint para configurar o banco de dados de destino do Timestream de forma semelhante à utilização de atributos de conexão adicional. Você especifica as configurações ao criar o endpoint de destino utilizando o console do AWS DMS ou o comando create-endpoint na AWS CLI, com a sintaxe --timestream-settings '{"EndpointSetting": "value", ...}' do JSON.

A tabela a seguir mostra as configurações de endpoint que é possível utilizar com o Timestream como destino.

Criar e modificar um endpoint de destino do Amazon Timestream

Depois de criar um perfil do IAM e estabelecer o conjunto mínimo de permissões de acesso, você poderá criar um endpoint de destino do Amazon Timestream usando o console do AWS DMS ou o comando create-endpoint naAWS CLI com a sintaxe --timestream-settings '{"EndpointSetting": "value", ...}' do JSON.

Os exemplos a seguir mostram como criar e modificar um endpoint de destino do Timestream usando a AWS CLI.

Criar comando do endpoint de destino do Timestream

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,
}

Modificar comando do endpoint de destino do Timestream

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,
}

Utilizar o mapeamento de objetos para migrar dados para um tópico do Timestream

O AWS DMS utiliza regras de mapeamento de tabelas para correlacionar dados da origem com o tópico de destino do Timestream. Para mapear dados para um tópico de destino, utilize um tipo de regra de mapeamento de tabelas chamado mapeamento de objetos. Utilize o mapeamento de objetos para definir como os registros de dados na origem são correlacionados com os registros de dados publicados em um tópico do Timestream.

Os tópicos do Timestream não têm uma estrutura predefinida, exceto uma chave de partição.

Para criar uma regra de mapeamento de objetos, especifique rule-type como object-mapping. Essa regra especifica o tipo de mapeamento de objeto que você deseja usar. A estrutura da regra é a seguinte:

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

Atualmente, o AWS DMS oferece suporte a map-record-to-record e map-record-to-document como os únicos valores válidos para o parâmetro rule-action. Os valores map-record-to-record e map-record-to-document especificam o que o AWS DMS faz por padrão com registros que não são excluídos como parte da lista de atributos exclude-columns. Esses valores não afetam os mapeamentos de atributos de forma alguma.

Utilize map-record-to-record ao migrar de um banco de dados relacional para um tópico do Timestream. Esse tipo de regra utiliza o valor taskResourceId.schemaName.tableName encontrado no banco de dados relacional como a chave de partição no tópico do Timestream e cria um atributo para cada coluna no banco de dados de origem. Ao usar map-record-to-record, para qualquer coluna na tabela de origem que não aparece na lista de atributos exclude-columns, o AWS DMS cria um atributo correspondente no tópico de destino. Este atributo correspondente é criado, independentemente de a coluna de origem ser usada ou não em um mapeamento de atributos.

Uma maneira de compreender o map-record-to-record é vê-lo em ação. Para este exemplo, suponha que você está começando com uma linha de tabela do banco de dados relacional com a seguinte estrutura de dados:

Para migrar essas informações de um esquema chamado Test para um tópico do Timestream, crie regras para correlacionar os dados com o tópico de destino. A regra a seguir ilustra o mapeamento.

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

Com um tópico do Timestream e uma chave de partição determinados (neste caso, taskResourceId.schemaName.tableName), o seguinte ilustra o formato do registro resultante utilizando os nossos exemplos de dados no tópico de destino do Timestream:

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

Limitações do uso do Amazon Timestream como destino para o AWS Database Migration Service

As seguintes limitações se aplicam ao utilizar o Amazon Timestream como destino: