本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 还原 Amazon Timestream 表
<a name="timestream-restore"></a>

还原 Amazon Timestream 表时，需要配置多个选项，包括新表名称、目的地数据库、存储分配首选项（内存和磁性存储）以及将使用哪个角色来完成还原作业。您还可以选择一个 Amazon S3 存储桶来存储错误日志。磁性存储写入异步进行，因此您可能希望记录错误。

Timestream 数据存储有两层：内存存储和磁性存储。内存存储为必需项，但您可以选择在指定的内存时间结束后将还原后的表传输到磁性存储。内存存储针对高吞吐量数据写入和快速 point-in-time查询进行了优化。磁性存储针对吞吐量较低的延迟数据写入、长期数据存储和快速分析查询进行了优化。

还原 Timestream 表时，您可以确定希望该表在每个存储层中保留多长时间。您可以使用控制台或 API为两者设置存储时间。请注意，存储采用线性和顺序方式。Timestream 会先将还原后的表存储在内存存储中，然后在达到内存存储时间后自动将其转换到磁性存储。

**注意**  
磁性存储保留期必须等于或大于原始保留期（显示在控制台右上角），否则数据将丢失。

*示例：*您将内存存储分配设置为将数据保存一周，并将磁性存储分配设置为将相同的数据保存一年。当内存存储中的数据保存一周后，它会自动移至磁性存储。然后，它会保存在磁性存储中一年时间。在该时间结束时，会从 Timestream 和 AWS Backup中将其删除。

## 使用控制台恢复 Amazon Timestream 表 AWS Backup
<a name="timestream-restore-console"></a>

您可以在 AWS Backup 控制台中恢复由 AWS Backup创建的 Timestream 表。

1. 在 [https://console.aws.amazon.com/backup](https://console.aws.amazon.com/backup) 上打开 AWS Backup 控制台。

1. 在导航窗格中，选择**受保护的资源**和要还原的 Amazon Timestream 资源 ID。

1. 在 **Resource details (资源详细信息)** 页面上，将显示所选资源 ID 的恢复点列表。要还原资源，请在**备份**窗格中，选择资源的恢复点 ID 旁边的单选按钮。在窗格的右上角，选择**还原**。

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)。

要使用恢复时间流 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
```