本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Amazon Timestream 作為 AWS Database Migration Service 的目標

在支援全負載和 CDC 資料遷移的情況下，您可以使用 AWS Database Migration Service 將資料從來源資料庫遷移到 Amazon Timestream 目標端點。

Amazon Timestream 是一項專為大量資料擷取而建置之快速、可擴展且無伺服器的時間序列資料庫服務。時間序列資料是在一段時間間隔內收集的資料點序列，用於測量隨時間變更的事件。它可用來收集、儲存和分析來自 IoT 應用程式、應用程式和分析 DevOps 應用程式的指標。在 Timestream 中取得資料後，您可以近乎即時地視覺化並識別資料中的趨勢和模式。如需 Amazon Timestream 的詳細資訊，請參閱 Amazon Timestream 開發人員指南中的什麼是 Amazon Timestream？。

使用 Amazon Timestream 做為 AWS Database Migration Service 的目標的事前準備

在您設定 Amazon Timestream 做為 AWS DMS 的目標之前，請務必建立 IAM 角色。此角色必須允許 AWS DMS 存取要遷移到 Amazon Timestream 的資料。下列 IAM 政策顯示您用來遷移至 Timestream 之角色的最低存取權限集。

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

如果您要遷移所有資料表，請在上述範例中使用 TABLE_NAME 的 *。

請注意以下有關使用 Timestream 做為目標的事項：

多執行緒完全載入任務設定

為協助加快資料傳輸速度，AWS DMS 運用下列任務設定來支援多執行緒完全載入遷移任務至 Timestream 目標端點：

多執行緒 CDC 載入任務設定

為提升 CDC 效能，AWS DMS 支援下列任務設定：

使用 Timestream 做為 AWS DMS 的目標時的端點設定

您可以使用端點設定來設定您的 Timestream 目標資料庫，類似於使用額外的連線屬性。您可以在使用 AWS DMS 主控台建立目標端點時指定設定，或使用 AWS CLI 中的 create-endpoint 命令，以 --timestream-settings '{"EndpointSetting": "value", ...}' JSON 語法指定設定。

下列資料表顯示您可搭配 Timestream 做為目標使用的端點設定。

建立和修改 Amazon Timestream 目標端點

建立 IAM 角色並建立最低存取權限集後，您可以使用 AWS DMS 主控台，或使用 AWS CLI 中的 create-endpoint 命令搭配 --timestream-settings '{"EndpointSetting": "value", ...}' JSON 語法來建立 Amazon Timestream 目標端點。

以下範例示範如何使用 AWS CLI 建立和修改 Timestream 目標端點。

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

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

使用物件映射將資料遷移到 Timestream 主題

AWS DMS 使用資料表映射規則，將來源資料映射到目標 Timestream 主題。若要將資料映射到目標主題，請使用一種稱為物件映射的資料表映射規則。您可以使用物件映射定義如何將來源中的資料記錄映射到發佈到 Timestream 主題的資料記錄。

除了擁有分割區索引鍵外，Timestream 主題沒有預設結構。

若要建立物件映射規則，請將 rule-type 指定為 object-mapping。此規則指定您想要使用的物件映射類型。規則的結構如下。

{
    "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 目前僅支援 map-record-to-record 和 map-record-to-document 做為 rule-action 參數的有效值。對於 exclude-columns 屬性清單中未排除的記錄，map-record-to-record 和 map-record-to-document 值指定了 AWS DMS 的預設處理方式。這些值反正不會影響屬性映射。

從關聯式資料庫遷移到 Timestream 主題時，請使用 map-record-to-record。此規則類型使用關聯式資料庫的 taskResourceId.schemaName.tableName 值做為 Timestream 主題的分割區索引鍵，並會為來源資料庫中的每一欄建立一個屬性。使用 map-record-to-record 時，針對所有未列在 exclude-columns 屬性清單中的來源資料表資料行，AWS DMS 會在目標主題中建立對應的屬性。無論屬性映射中是否使用該來源資料行，都會建立此對應的屬性。

了解 map-record-to-record 的一種方法是查看它運作時的狀態。在本範例中，假設您開始使用之關聯式資料庫資料表資料列的結構和資料如下。

若要將此資訊從名為 Test 的結構描述遷移至 Timestream 主題，您可以建立規則以將資料映射至目標主題。以下規則說明映射。

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

指定 Timestream 主題和分割區索引鍵 (在本例中為 taskResourceId.schemaName.tableName)，下列說明使用我們在 Timestream 目標主題中的範例資料所產生的記錄格式：

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

使用 Amazon Timestream 做為 AWS Database Migration Service 的目標時的限制

使用 Amazon Timestream 做為目標時，有下列限制：