Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

如何 point-in-time 恢复在亚马逊 Keyspaces 中有效

本部分提供 Amazon Keyspaces 的概述。 point-in-time 恢复 (PITR) 有效。有关定价的更多信息，请参阅Amazon Keyspaces（针对 Apache Cassandra）定价.

启用 point-in-time 恢复（PITR）

您可以使用控制台启用 PITR，也可以以编程方式启用它。

使用控制台启用 PITR

新表的 PITR 设置可以在自定义设置选项。默认情况下，在通过控制台创建的新表上启用 PITR。

要为现有表启用 PITR，请完成以下步骤。

您可以随时通过以下步骤禁用表上的 PITR。

要了解如何使用控制台还原表，请参阅将表还原到某个时间点 (控制台).

使用启用 PITRAmazon CLI

您可以使用UpdateTableAPI。

使用创建新表时使用Amazon CLI在创建新表时，您必须显式启用 PITR。

要在创建新表时启用 PITR，可以使用以下命令：Amazon CLI以命令为例。为了提高可读性，该命令已分成单独的行。

aws keyspaces create-table --keyspace-name 'myKeyspace' --table-name 'myTable' 
            --schema-definition 'allColumns=[{name=id,type=int},{name=name,type=text},{name=date,type=timestamp}],partitionKeys=[{name=id}]' 
            --point-in-time-recovery 'status=ENABLED'

要确认 point-in-time 表的恢复设置，您可以使用以下内容：Amazon CLI命令。

aws keyspaces get-table --keyspace-name 'myKeyspace' --table-name 'myTable'

要使用为现有表启用 PITRAmazon CLI中，运行以下命令。

aws keyspaces update-table --keyspace-name 'myKeyspace' --table-name 'myTable' --point-in-time-recovery 'status=ENABLED'

要在现有表上禁用 PITR，请运行以下命令：Amazon CLI命令。

aws keyspaces update-table --keyspace-name 'myKeyspace' --table-name 'myTable' --point-in-time-recovery 'status=DISABLED'

使用 CQL 启用 PITR

您可以使用point_in_time_recovery自定义属性。

使用 CQL 创建新表时，必须在创建新表时显式启用 PITR。

要在创建新表时启用 PITR，可以使用以下 CQL 命令作为示例。

CREATE TABLE "my_keyspace1"."my_table1"(
	"id" int,
	"name" ascii,
	"date" timestamp,
	PRIMARY KEY("id"))
WITH CUSTOM_PROPERTIES = {
	'capacity_mode':{'throughput_mode':'PAY_PER_REQUEST'}, 
	'point_in_time_recovery':{'status':'enabled'}
}

要使用 CQL 为现有表启用 PITR，请运行以下 CQL 命令。

ALTER TABLE mykeyspace.mytable
WITH custom_properties = {'point_in_time_recovery': {'status': 'enabled'}}

要在现有表中禁用 PITR，请运行以下 CQL 命令。

ALTER TABLE mykeyspace.mytable
WITH custom_properties = {'point_in_time_recovery': {'status': 'disabled'}}

有关 CQL 语言参考中的更多信息，请参阅CREATE TABLE和ALTER TABLE. 要了解如何使用 CQL 还原表，请参阅使用 CQL 将表还原到某个时间点.

还原表所需的权限

要成功还原表，IAM 用户或角色需要以下最低权限：

下面是一个策略示例，该策略向用户授予还原密钥空间中表所需的最低权限。mykeyspace.

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Effect":"Allow",
         "Action":[
            "cassandra:Restore",
            "cassandra:Select"
         ],
         "Resource":[
            "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/*",
            "arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*"
         ]
      }
   ]
}

根据其他选定的功能，可能需要额外的权限才能恢复表。例如，如果源表使用客户托管密钥进行静态加密，则 Amazon Keyspaces 必须具有访问源表的客户托管密钥的权限才能成功还原表。有关更多信息，请参阅 PITR 恢复加密表。

如果您使用 IAM 策略条件键要将传入流量限制到特定来源，您必须确保 Amazon Keyspaces 有权代表您的委托人执行还原操作。您必须添加aws:ViaAWSService如果您的策略将传入流量限制为以下任何一项，则为 IAM 策略的条件密钥：

这些区域有：aws:ViaAWSService条件密钥允许在任何时候访问Amazon服务使用委托人的凭证发出请求。有关更多信息，请参阅 。IAM JSON 策略元素：条件键中的IAM 用户指南.

以下是一个策略示例，该策略将源流量限制为特定 IP 地址，并允许 Amazon Keyspaces 代表委托人还原表。

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Sid":"CassandraAccessForCustomIp",
         "Effect":"Allow",
         "Action":"cassandra:*",
         "Resource":"*",
         "Condition":{
            "Bool":{
               "aws:ViaAWSService":"false"
            },
            "ForAnyValue:IpAddress":{
               "aws:SourceIp":[
                  "123.45.167.89"
               ]
            }
         }
      },
      {
         "Sid":"CassandraAccessForAwsService",
         "Effect":"Allow",
         "Action":"cassandra:*",
         "Resource":"*",
         "Condition":{
            "Bool":{
               "aws:ViaAWSService":"true"
            }
         }
      }
   ]
}

有关使用的示例策略aws:ViaAWSService全局条件键，请参阅VPC 终端节点和 Amazon Keyspaces 时间点恢复 (PITR).

PITR 连续备份的时间窗口

Amazon Keyspaces PITR 使用两个时间戳来维护表可恢复备份的时间范围。

启用 PITR 后，您可以还原到之间的任何时间点EarliestRestorableDateTime和CurrentTime. 您只能将表数据还原到启用 PITR 的时间。

如果禁用 PITR 然后再次重新启用它，则将第一个可用备份的开始时间重置为重新启用 PITR 的时间。这意味着禁用 PITR 会删除备份历史记录。

还原表不必处于活动状态。如果已删除的表启用了 PITR，并且删除是在备份窗口内（或过去 35 天内）发生的，也可以恢复已删除的表。

PITR 还原设置

当您使用 PITR 还原表时，Amazon Keyspaces 会根据所选时间戳将源表的架构和数据恢复到状态（day:hour:minute:second）到新表上。PITR 不会覆盖现有表。

除了表的架构和数据外，PITR 还原custom_properties从源表中。与表的数据（基于最早还原时间和当前时间之间的选定时间戳还原）不同，自定义属性始终会根据表的设置在当前时间内恢复。

还原表的设置将源表的设置与启动恢复的时间戳相匹配。如果要在还原过程中覆盖这些设置，可以使用WITH custom_properties. 自定义属性包括以下设置。

执行完整表还原时，还原表的所有表设置都来自还原时源表的当前设置。

例如，假设一个表的预配置的吞吐量最近下降到 50 个读取容量单位和 50 个写入容量单位。然后，你将表的状态恢复到三周前。目前，其预配置吞吐量为 100 个读取容量单位和 100 个写入容量单位。在此情况下，Amazon Keyspaces 将表数据还原到该时间点，但使用当前预配置吞吐量设置（50 个读取容量单位和 50 个写入容量单位）。

以下设置不会恢复，您必须为新表手动配置它们。

PITR 恢复加密表

当您使用 PITR 还原表时，Amazon Keyspaces 会恢复源表的加密设置。如果表格是用Amazon 拥有的密钥（默认值），表将自动使用相同的设置恢复。如果要恢复的表是使用客户托管密钥加密的，则 Amazon Keyspace 需要可以访问相同的客户托管密钥才能恢复表数据。

您可以在恢复时更改表的加密设置。从更改Amazon 拥有的密钥对于客户管理的密钥，您需要在恢复时提供有效且可访问的客户托管密钥。

如果你想从客户管理的密钥更改为Amazon 拥有的密钥中，确认 Amazon Keyspaces 有权访问源表的客户管理密钥以使用Amazon 拥有的密钥. 有关表静态加密设置的更多信息，请参阅静态加密：它在亚马逊 Keyspaces 中的运作方.

使用 PITR 恢复表时间

还原表所用的时间取决于多个因素，并不总是直接与表的大小相关。

以下是还原时的一些注意事项。

规划灾难恢复的最佳做法是定期记录平均还原完成时间，并确定这些时间对整个恢复时间目标的影响。

亚马逊 Keyspaces PITR 和与Amazon服务

使用记录以下 PITR 操作Amazon CloudTrail以实现持续监控和审计。

有关更多信息，请参阅 使用 记录 Amazon Keyspaces API 调用Amazon CloudTrail。

可以使用以下方法执行以下 PITR 操作：Amazon CloudFormation.

有关更多信息，请参阅 。Cassandra 资源类型参考中的Amazon CloudFormation用户指南.