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

# 還原 Amazon Timestream 資料表
<a name="timestream-restore"></a>

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

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

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

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

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

## 使用 AWS Backup 主控台還原 Amazon Timestream 資料表
<a name="timestream-restore-console"></a>

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

1. 在 https：//[https://console.aws.amazon.com/backup](https://console.aws.amazon.com/backup) 開啟 AWS Backup 主控台。

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

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

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

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

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

1. **儲存配置**：設定還原的資料表最初在[記憶體儲存](https://docs.aws.amazon.com/timestream/latest/developerguide/storage.html)中的時間，並設定還原的資料表接著在[磁性儲存](https://docs.aws.amazon.com/timestream/latest/developerguide/storage.html)中的時間。記憶體儲存可設定為數小時、數天、數週或數月。磁性儲存可設定為數天、數週、數月或數年。

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

1. (選擇性)** **Amazon S3 錯誤日誌位置**：您可以指定儲存錯誤日誌的 S3 位置。瀏覽您的 S3 檔案，或複製並貼上 S3 檔案路徑。
**注意**  
如果您選擇指定 S3 錯誤日誌位置，則用於此還原的角色必須具有寫入至 S3 儲存貯體的許可，或必須包含具有該許可的政策。

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

1. 按一下 **還原備份**。

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

## 使用 API、CLI 或 SDK 還原 Amazon Timestream 資料表
<a name="timestream-restore-api"></a>

使用 [`StartRestoreJob` 透過 API 還原 Timestream 資料表](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html)。

若要使用 還原 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
```

您也可以使用 [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_DescribeRestoreJob.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_DescribeRestoreJob.html) 來協助取得還原資訊。

在 中 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
```