将 Amazon Keyspaces 表还原到某个时间点

以下示例演示如何使用 Amazon Keyspaces 控制台还原名为的现有表。mytable到某个时间点。

1. 登录到Amazon Web Services Management Console，然后打开亚马逊 Keyspaces 控制台https://console.aws.amazon.com/keyspaces/home.

2. 在控制台左侧的导航窗格中，选择 Tables (表)。

3. 在表的列表中，选择 mytable 表。

4. 在存储库的备份的选项卡mytable表格，在时间点恢复部分，选择还原.

5. 对于新表名称，输入 mytable_restored。

6. 要定义还原操作的时间点，您可以选择两个选项：

   • 选择预配置最早时间。

   • Select指定日期和时间然后输入要将新表还原到的日期和时间。

   注意

   您可以还原到内部的任何时间点最早时间和当前时间。Amazon Keyspaces 将您的表数据还原到基于选定的日期和时间的状态（日:time: time: min: min: second)。

7. 选择还原以启动还原过程。

   正在还原的表显示状态为 Restoring (正在还原)。还原过程完成后，mytable_restored 表的状态更改为 Active (活动)。

   重要

   正在还原时，请勿修改或删除授予 IAM 实体（例如，用户、组或角色）执行还原的权限的 Amazon Identity and Access Management (IAM) 策略。否则，可能会出现意外行为。例如，假设您在还原表时删除了对该表的写入权限。在这种情况下，底层 RestoreTableToPointInTime 操作将无法向表中写入任何还原的数据。

   您只能在还原操作完成之后修改或删除权限。

1. 在第一步中，您将创建一个名为的简单表。myTable已启用 PITR。为了便于阅读，该命令分成单独的行。

   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'

2. 确认新表的属性并查看earliestRestorableTimestamp对于 PITR。

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

   此命令的输出将返回以下内容。

   {
       "keyspaceName": "myKeyspace",
       "tableName": "myTable",
       "resourceArn": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/myKeyspace/table/myTable",
       "creationTimestamp": "2022-06-20T14:34:57.049000-07:00",
       "status": "ACTIVE",
       "schemaDefinition": {
           "allColumns": [
               {
                   "name": "id",
                   "type": "int"
               },
               {
                   "name": "date",
                   "type": "timestamp"
               },
               {
                   "name": "name",
                   "type": "text"
               }
           ],
           "partitionKeys": [
               {
                   "name": "id"
               }
           ],
           "clusteringKeys": [],
           "staticColumns": []
       },
       "capacitySpecification": {
           "throughputMode": "PAY_PER_REQUEST",
           "lastUpdateToPayPerRequestTimestamp": "2022-06-20T14:34:57.049000-07:00"
       },
       "encryptionSpecification": {
           "type": "AWS_OWNED_KMS_KEY"
       },
       "pointInTimeRecovery": {
           "status": "ENABLED",
           "earliestRestorableTimestamp": "2022-06-20T14:35:13.693000-07:00"
       },
       "defaultTimeToLive": 0,
       "comment": {
           "message": ""
       }
   }

   您可以将活动表还原到任何 point-in-time 介于earliestRestorableTimestamp以及每秒钟内的当前时间。当前时间是默认值。

3. 要将表还原到某个时间点，请指定restore_timestamp采用 ISO 8601 格式。您可以在每秒间隔内选择最近 35 天中的任何时间点。例如，以下命令使表还原到 EarliestRestorableDateTime。

   aws keyspaces restore-table --source-keyspace-name 'myKeyspace' --source-table-name 'myTable' --target-keyspace-name 'myKeyspace' --target-table-name 'myTable_restored' --restore-timestamp "2022-06-20 21:35:14.693"

   此命令的输出将返回还原表的 ARN。

   {
       "restoredTableARN": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/myKeyspace/table/myTable_restored"
   }

   要将表恢复到当前时间，可以省略restore-timestamp.

   aws keyspaces restore-table --source-keyspace-name 'myKeyspace' --source-table-name 'myTable' --target-keyspace-name 'myKeyspace' --target-table-name 'myTable_restored1'"

1. 您可以将活动表还原到 point-in-time 之间earliest_restorable_timestamp以及当前时间。当前时间是默认值。

   为了确认 point-in-time 已启用恢复mytable表中，查询system_schema_mcs.tables如下所示。

   SELECT custom_properties
   FROM system_schema_mcs.tables
   WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';

   如下面的示例输出所示，启用了时间点恢复。

   custom_properties
   -----------------
   {
     ...,
       "point_in_time_recovery": {
       "earliest_restorable_timestamp":"2020-06-30T19:19:21.175Z"
       "status":"enabled"
     }
   }

2. 将表还原到某个时间点，由restore_timestamp采用 ISO 8601 格式。在这种情况下，mytable表将恢复到当前时间。您可以省略WITH restore_timestamp = ...子句。如果没有该子句，则使用当前时间戳。

   RESTORE TABLE mykeyspace.mytable_restored
   FROM TABLE mykeyspace.mytable;

   您还可以还原到特定时间点。您可以指定最近 35 天内的任何时间点。例如，以下命令使表还原到 EarliestRestorableDateTime。

   RESTORE TABLE mykeyspace.mytable_restored
   FROM TABLE mykeyspace.mytable
   WITH restore_timestamp = '2020-06-30T19:19:21.175Z';

   有关完整的语法说明，请参阅还原表在语言参考中。

1. 删除您在上一教程中创建的表。

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

2. 使用以下命令将已删除的表恢复到删除时。

   aws keyspaces restore-table --source-keyspace-name 'myKeyspace' --source-table-name 'myTable' --target-keyspace-name 'myKeyspace' --target-table-name 'myTable_restored2'

   此命令的输出将返回还原表的 ARN。

   {
       "restoredTableARN": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/myKeyspace/table/myTable_restored2"
   }

1. 为了确认 point-in-time 已删除表启用恢复，请查询系统表。只有带有 point-in-time 此时将显示启用恢复。

   SELECT custom_properties
   FROM system_schema_mcs.tables_history 
   WHERE keyspace_name = 'mykeyspace' AND table_name = 'my_table';

   此查询将显示以下输出。

   custom_properties
   ------------------
   {
       ...,
      "point_in_time_recovery":{
         "restorable_until_time":"2020-08-04T00:48:58.381Z",
         "status":"enabled"
      }
   }

2. 使用以下示例语句将表恢复到删除时间。

   RESTORE TABLE mykeyspace.mytable_restored
   FROM TABLE mykeyspace.mytable;