恢复指定的表

OceanBase 数据库支持物理恢复租户内指定的表。

前提条件

请确认已完成恢复前准备，具体操作请参见 恢复前准备。

恢复租户内指定的表

1. 使用 root 用户登录数据库的 sys 租户。

2. 执行以下语句，开始执行恢复任务。

   obclient> ALTER SYSTEM RESTORE  <table_name_list> FOR <dest_tenant_name>  FROM <source_tenant_name> AT 'uri'  UNTIL 'timestamp' WITH 'restore_option' ;
   

   部分参数说明如下表所示。

   参数	描述
   table_name_list	指定待恢复的租户内的表，表名需要包含表所在的数据库名（MySQL 模式）或表所属的 Owner（Oracle 模式），多个表名之间中用英文逗号（,）连接。 单个表的表示方法：database_name.table_name 或 user_name.table_name 示例：crm.sales,crm.products,hr.employees 说明 数据库名或表名可能含有特殊字符，对于含特殊字符的数据库名或表名需要放在反引号（``）内。例如：`c&rm`.`s#ales`。
   dest_tenant_name	指恢复的新租户的名称。
   source_tenant_name	指源集群的租户名。
   uri	指备份时设置的 backup_dest。
   timestamp	指恢复的时间戳，需要大于等于最早备份的数据备份的 CDB_OB_BACKUP_SET_DETAILS 的 START_TIME，小于等于日志备份 CDB_OB_BACKUP_ARCHIVELOG_SUMMARY 的MAX_NEXT_TIME。
   restore_options	支持 backup_cluster_name、backup_cluster_id、pool_list、locality、primary_zone、kms_encrypt： backup_cluster_name 为必选项，填写源集群的名称。 backup_cluster_id 为必选项，填写源集群的 cluster_id pool_list 为必选项，填写用户的资源池。多个资源池之间用英文逗号（,）分隔。 locality 为可选项，填写新租户副本分布的 Locality 信息，需要满足与新租户所在集群的 pool_list 的 Zone 信息相匹配，默认使用源租户的 Locality。若填写的信息与新租户所在集群的 pool_list 的 Zone 信息不匹配，则系统会重置为缺省 Locality，即按 resource_pool 的 zone_list 为每个 Zone 设一个 F 副本。 例如，源租户的 Locality 为 "F@z1,F@z2,F@z3"，新租户所在集群的 Zone 分布为 "z1,z2,z3,z4"，则新租户的 Locality 使用源租户的 Locality。若源租户的 Locality为 "F@z1,F@z2,F@z3,F@z4,F@z5"，新租户所在集群的 Zone 分布为 "z1,z2,z3"，则新租户的 Locality 使用所在集群的全部的 Zone，即新租户的 Locality 为 "F@z1,F@z2,F@z3"。 primary_zone 为可选项，填写新租户的 Leader 副本的偏好位置，需要满足与 pool_list 及 locality 的匹配，即需要满足 Zone 信息匹配以及 primary_region 内至少有两个 Paxos 成员等限制，默认使用源租户的 Primary Zone。若填写的信息与新租户所在集群的 pool_list 及 locality 不匹配，则系统会将其重置为缺省 primary_zone，即按 locality 的 zone_list 将 Leader 随机分布在这些 Zone 中。 例如，源租户的 Locality 为 "F@z1,F@z2,F@z3"，Primary Zone 为 z1，新租户所在集群的 Zone 分布为 "z1,z2,z3,z4"，则新租户的 Primary Zone 也为 z1。若源租户的 Locality 为 "F@z1,F@z2,F@z3,F@z4,F@z5"，Primary Zone 为 z1，新租户所在集群的 Zone 分布是"z1,z2,z3"，则新租户的 Locality 为 "F@z1,F@z2,F@z3"， 同时 Primary Zone 为 "z1,z2,z3"。 kms_encrypt 为可选项，为 true 则表示在恢复时需要使用恢复准备操作中指定的 kms_encrypt_info。

   以下示例表示从租户 tenant1 的备份中将表 sales、products 和 orders 恢复到 new_tenant1 中，恢复出来的数据版本为 2021-02-28 08:59:45。

   obclient> ALTER SYSTEM RESTORE crm.sales, crm.products, hr.employees FOR new_tenant1 FROM tenant1 AT 'oss://antsys-oceanbasebackup/backup_rd/?host=cn-hangzhou-alipay-b.oss-cdn.aliyun-inc.com&access_id=xxx&access_key=xxx' UNTIL '2021-02-28 08:59:45' WITH 'backup_cluster_name=ob20daily.backup&backup_cluster_id=1&pool_list=restore_pool';