還原 Amazon Timestream 資料表 - AWS Backup
使用 AWS Backup 主控台還原 Amazon Timestream 資料表使用 API、 CLI或 還原 Amazon Timestream 資料表 SDK

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

還原 Amazon Timestream 資料表

當您還原 Amazon Timestream 資料表時，有幾個選項可供設定，包括新資料表名稱、目的地資料庫、您的儲存配置偏好設定 (記憶體和磁性儲存)，以及您用於完成還原任務的角色。您也可以選擇 Amazon S3 儲存貯體來儲存錯誤日誌。磁性儲存寫入是非同步的，因此您可能想要記錄錯誤。

Timestream 資料儲存有兩個層級：記憶體存放區和磁性存放區。記憶體存放區是必要項目，但您可以選擇在指定的記憶體時間結束之後，將還原的資料表傳輸至磁性存放區。記憶體存放區已針對高輸送量資料寫入和快速 point-in-time查詢進行最佳化。磁性存放區已針對較低輸送量延遲抵達資料寫入、長期資料儲存和快速分析查詢優化。

當您還原 Timestream 資料表時，您可以確定資料表在每個儲存層中保留多久。您可以使用主控台或 API，為兩者設定儲存時間。請注意，儲存是線性且循序的。Timestream 會先將還原的資料表儲存在記憶體儲存中，然後在達到記憶體儲存時間時，自動將其轉換至磁性儲存。

注意

磁性存放區保留期必須等於或大於原始保留期 (顯示在主控台的右上方)，否則資料將會遺失。

範例：您將記憶體存放區配置設定為保留資料一週，並將磁性存放區配置設定為保留相同資料一年。當記憶體存放區中的資料經過一週時，就會自動移至磁性存放區。然後會在磁性存放區中保留一年。該時間結束時，就會從 Timestream 和 AWS Backup中刪除。

使用 AWS Backup 主控台還原 Amazon Timestream 資料表

您可以在 建立的 AWS Backup 主控台中還原 Timestream 資料表 AWS Backup。

  1. 在 https://console.aws.amazon.com/backup 開啟 AWS Backup 主控台。

  2. 在導覽窗格中，選擇 受保護的資源 和您要還原的 Amazon Timestream 資源 ID。

  3. Resource details (資源詳細資訊) 頁面上會顯示所選資源 ID 的復原點清單。若要還原資源，請在 Backups (備份) 窗格中，選擇資源復原點 ID 旁邊的選項按鈕。在窗格右上角，選擇 Restore (還原)。

  4. 指定您的新資料表組態設定，包括：

    1. 新資料表名稱，由 2 到 256 個字元 (字母、數字、連字號、句號和底線) 組成。

    2. 目的地資料庫，請從下拉式選單中選擇。

  5. 儲存配置：設定還原的資料表最初在記憶體儲存中的時間，並設定還原的資料表接著在磁性儲存中的時間。記憶體儲存可設定為數小時、數天、數週或數月。磁性儲存可設定為數天、數週、數月或數年。

  6. (選擇性) 啟用磁性儲存寫入：您可以選擇允許磁性儲存寫入。勾選此選項時，延遲抵達的資料 (時間戳記超出記憶體儲存保留期的資料) 將直接寫入至磁性存放區中。

  7. (選擇性) Amazon S3 錯誤日誌位置：您可以指定儲存錯誤日誌的 S3 位置。瀏覽您的 S3 檔案，或複製並貼上 S3 檔案路徑。

    注意

    如果您選擇指定 S3 錯誤日誌位置，則用於此還原的角色必須具有寫入至 S3 儲存貯體的許可，或必須包含具有該許可的政策。

  8. 選擇要傳遞IAM的角色以執行還原。您可以使用預設IAM角色或指定不同的角色。

  9. 按一下 還原備份。

您的還原任務會顯示在受保護的資源下方。您可以按一下重新整理按鈕或 CTRL-R，查看還原任務的目前狀態。

使用 API、 CLI或 還原 Amazon Timestream 資料表 SDK

使用 StartRestoreJob 透過 還原 Timestream 資料表API。

若要使用 還原 Timestream AWS CLI，請使用 操作start-restore-job.並指定下列中繼資料：

TableName: string;
DestinationDatabase: string;
MemoryStoreRetentionPeriodInHours: value: number unit: 'hours' | 'days' | 'weeks' | 'months' 
MagneticStoreRetentionPeriodInDays: value: number unit: 'days' | 'weeks' | 'months' | 'years' 
EnableMagneticStoreWrites?: boolean;
aws:backup:request-id

以下是範例範本：

aws backup start-restore-job \
--recovery-point-arn "arn:aws:backup:us-west-2:accountnumber:recovery-point:1a2b3cde-f405-6789-012g-3456hi789012_beta" \
--iam-role-arn "arn:aws:iam::accountnumber:role/rolename" \
--metadata 'TableName=tablename,DatabaseName=databasename,MagneticStoreRetentionPeriodInDays=1,MemoryStoreRetentionPeriodInHours=1,MagneticStoreWriteProperties="{\"EnableMagneticStoreWrites\":true,\"MagneticStoreRejectedDataLocation\":{\"S3Configuration\":{\"BucketName\":\"bucketname\",\"EncryptionOption\":\"SSE_S3\"}}}"' \
--region us-west-2 \
--endpoint-url url

您也可以使用 DescribeRestoreJob 來協助取得還原資訊。

在 中 AWS CLI，使用 操作describe-restore-job並使用下列中繼資料：

TableName: string;
DestinationDatabase: string;
MemoryStoreRetentionPeriodInHours: value: number unit: 'hours' | 'days' | 'weeks' | 'months' 
MagneticStoreRetentionPeriodInDays: value: number unit: 'days' | 'weeks' | 'months' | 'years' 
EnableMagneticStoreWrites?: boolean;

以下是範例範本：

aws backup describe-restore-job \
--restore-job-id restore job ID \
--region awsregion \
--endpoint-url url