--- title: "表级恢复相关参数介绍 - OceanBase 数据库 V4.3.5 | OceanBase 文档中心" description: "表级恢复相关参数介绍 本节主要对表级恢复命令中的相关参数进行介绍。 表级恢复命令相关 命令 表级恢复 ALTER SYSTEM RECOVER TABLE table_name_list TO [TENANT [=]] dest_tenant_name FROM uri [UNTIL {TIME='timestamp…" --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.5 LTS # 表级恢复相关参数介绍 更新时间：2026-04-07 20:57:20 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.5/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-1000000002016015)。 - 对于 `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://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013165)。 ### 跨租户导表阶段 **命令** ```sql ALTER SYSTEM SET ddl_thread_score = int_value Tenant=tenant_name; ``` ```sql ALTER SYSTEM SET recover_table_concurrency= int_value Tenant=tenant_name; ``` ```sql ALTER SYSTEM SET recover_table_dop = int_value Tenant=tenant_name; ``` ***参数解释*** | 参数 | 描述 | | --- | --- | | [ddl_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002015540) | 用于控制租户 OBServer 节点上表级恢复线程池的数量。默认值为 0，表示内部默认线程数为 2。 | | [recover_table_concurrency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002015602) | 用于控制租户多表并行恢复的并行度，指定最多允许 `recover_table_concurrency` 个表同时执行跨租户导表。默认值为 0，表示内部默认最多允许 1 个表执行跨租户导表。 | | [recover_table_dop](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002015541) | 用于控制单表恢复的并行度。默认值为 0，表示内部默认并行度为 1。 该参数具体对以下两个阶段有影响： - 数据恢复阶段 系统将表的每个分区拆分成为最多 `recover_table_dop` 个恢复子任务，每个子任务由独立的表级恢复线程执行，实现并行恢复。 总并行度的计算公式：`单表最大并行度 = 分区总数 * recover_table_dop` 示例：假设当前恢复的表有 4 个分区，且 `recover_table_dop` 的值为 2，则总并行线程数为 `4*2=8`。 - 重建索引阶段 系统基于已经恢复的表数据，利用并行执行（Parallel Execution, PX）重建索引。PX 的并行度由 `recover_table_dop` 决定。有关 PX 的详细介绍及调优说明，参见 [并行执行](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002013746)。 | 上一篇 下一篇 ![有帮助](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) 咨询热线