---
title: github-fill
description: "按表恢复相关参数介绍 本节主要对按表恢复命令中的相关参数进行介绍。 恢复命令 按表恢复 ALTER SYSTEM RECOVER TABLE table_name_list TO [TENANT [=]] dest_tenant_name FROM uri [UNTIL {TIME='timestamp'} | {S…"
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.1

# 按表恢复相关参数介绍

更新时间：2026-04-10 11:58:01

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.1/zh-CN/600.manage/600.backup-and-recovery/700.recover-table/600.parameters-of-the-table-recovery.md)  

本节主要对按表恢复命令中的相关参数进行介绍。

## 恢复命令

- 按表恢复

  ```sql
  ALTER SYSTEM
  RECOVER TABLE table_name_list
  TO [TENANT [=]] dest_tenant_name
  FROM uri
  [UNTIL {TIME='timestamp'} | {SCN=scn} ]
  WITH 'restore_option'
  [WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password']
  [REMAP TABLE remap_table_name_list]
  [REMAP TABLEGROUP remap_tablegroup_list]
  [REMAP TABLESPACE remap_tablespace_list]
  [DESCRIPTION [=] description];

  ```
 - 取消正在进行的表级恢复任务

  ```sql
  ALTER SYSTEM CANCEL RECOVER TABLE dest_tenant_name;

  ```

## 参数解释

| 参数 | 描述 |
| --- | --- |
| table_name_list | 需要恢复的表，格式形如 `database_name.table_name1,database_name.table_name2,...`，多个表之间使用英文逗号（,）来分隔。   指定 `database_name` 和 `table_name` 时：   - 需要保证名称与系统实际存储的名称一致。      - 对于 Oracle 模式租户，`database_name` 的名称与表所在的用户名相同，同时 `database_name` 和 `table_name` 默认大小写不敏感，按照英文字母大写存储在内部表中。     - 对于 MySQL 租户，`database_name` 的名称为表所属的数据库名，同时 `database_name` 和 `table_name` 是否大小写敏感取决于创建源租户时指定的变量 `lower_case_table_names` 的值。         变量 `lower_case_table_names` 用于设置数据库名和表名是否对大小写敏感。如果创建租户时未指定该变量的值，则默认为数据库名和表名按照小写形式进行存储，并以不区分大小写的形式进行比较。有关变量 `lower_case_table_names` 的更多说明，请参见 [lower_case_table_names](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000821330)。 - 对于 `database_name` 或 `table_name` 中含有特殊字符的场景，含特殊字符的 `database_name` 或 `table_name` 需要放在反引号（``）内。 - 如果需要恢复一个 DataBase 下的所有表，则可以表示为 database_name.*。 - 如果需要恢复租户下的所有用户表，则可以表示为 *.*。 |
| dest_tenant_name | 表待恢复的目标租户名，仅支持将表恢复到用户租户中，不支持恢复到 `sys` 租户或 Meta 租户。 |
| uri | 分别指定数据备份和日志归档的路径，与租户级物理恢复命令的参数一样。若数据备份是通过 PLUS ARCHIVELOG 方式发起的，只需要填一个路径即可，否则需要分别输入数据备份和日志归档至少 2 个路径，例如：`'file:///backup/archive, file:///backup/data'`。 |
| {TIME='timestamp'} \| {SCN=scn} | 指定的恢复终点，恢复到该位点位置，且包含该位点。当指定恢复到 `TIME` 或 `SCN` 时, 必须以 `=` 来连接指定的值。如果不指定 `UNTIL` 子句，则默认恢复到最新的位点。 |
| restore_option | 支持 `pool_list`、`locality`、`primary_zone`、`concurrency`，不同参数之间通过 `&` 分隔。在指定 `locality` 和 `primary_zone` 时，建议尽量与源租户保持同构。   - `pool_list`：必选，填写用户的资源池。多个资源池之间用英文逗号（,）分隔。 - `locality`：可选，填写辅助租户副本分布的 Locality 信息，需要满足与辅助租户所在集群的 `pool_list` 的 Zone 信息相匹配。不填时，默认按照 resource_pool 的 `zone_list` 为每个 Zone 设一个 F 副本。     填写样例: `locality='F@z1,F@z2,F@z3'` - `primary_zone`：可选，填写辅助租户的 Leader 副本的偏好位置，需要满足与 `pool_list` 及 `locality` 的匹配，即需要满足 Zone 信息匹配以及 `primary_region` 内至少有两个 Paxos 成员等限制。不填时，则系统按照 `locality` 的 `zone_list` 将 Leader 随机分布在这些 Zone 中。      填写样例: `primary_zone='z1'` - `concurrency`：可选，指定数据恢复的并发度。如果不指定，则默认等于该租户被分配的 MAX_CPU 数。     填写样例：`concurrency=50` |
| WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password' | 指定加密租户的秘钥备份信息。仅当源租户配置了透明加密，才需要在恢复时指定秘钥备份相关的信息。其中：   - `backup_key_path`：秘钥的备份路径。 - `password`：备份秘钥时设置的加密密码。 |
| remap_table_name_list | 重命名恢复后的表名。支持仅重命名表名，表所属的 Database 不变；也支持表名不变，仅重命名到其他 Database；还支持重命名表名，同时所属的 Database 重命名为其他 Database。源对象与重命名对象之间使用英文冒号（:）连接，具体格式的示例如下：   - 表名从 `student` 重命名为 `student2`，表所属的 Database 不变：`REMAP TABLE school.student:student2`。     当所属的 Database 不变时，在恢复到目标租户创建表时，系统默认会将表恢复到目标租户同名的 Database 中，如果同名的 Database 不存在，则表恢复就会失败。 - 表名不变，表所属的 Database 从 `school` 改为 `college`：`REMAP TABLE school.student:college.student`。 - 表名从 `student` 重命名为 `student2`，表所属的 Database 从 `school` 改为 `college`：REMAP TABLE school.student:college.student2。 - 将 `school` 下的所有表恢复到 `college` 中：`REMAP TABLE school.:college.`。    #### 说明    如果重命名的 `database_name` 或 `table_name` 中含有特殊字符，则含特殊字符的 `database_name` 或 `table_name` 需要放在反引号（``）内。 |
| remap_tablegroup_list | 重命名表所属的表组。如果源表绑定了表组，则在恢复到目标租户创建表时，系统默认会将表恢复到目标租户中同名的表组，如果同名的表组不存在，表恢复就会失败。如果目标租户中有其他表组，可以将表通过该语句恢复到其他表组中，源对象与重命名对象之间使用英文冒号（:）连接。    例如，将源表组 `tg1` 中的表全部恢复到目标租户的表组 `newtg1` 中：`REMAP TABLEGROUP tg1:newtg1`。 |
| remap_tablespace_list | 重命名表所属的表空间。表空间在 OceanBase 数据库中是一个逻辑单元，当前主要用于数据加密。如果源表绑定了表空间，则在恢复到目标租户创建表时，系统默认会将表恢复到目标租户中同名的表空间，如果同名的表空间不存在，表恢复就会失败。如果目标租户中有其他表空间，也可以将表通过该语句恢复到其他表空间中，源对象与重命名对象之间使用英文冒号（:）连接。    例如，将源表空间 `ts1` 中的表全部恢复到目标租户的表空间 `newts1` 中：`REMAP TABLESPACE ts1:newts1`。 |

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线