---
title: "物理恢复相关参数介绍 | OceanBase 文档中心"
description: "物理恢复相关参数介绍 本节主要对恢复命令中的相关参数进行介绍。 恢复命令相关 命令 恢复到指定时间戳 ALTER SYSTEM RESTORE dest_tenant_name FROM uri UNTIL TIME='timestamp' WITH 'restore_option' [WITH KEY FROM '…"
---
切换语言

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

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

# 物理恢复相关参数介绍

更新时间：2026-06-26 09:52:50

[编辑](https://github.com/oceanbase/oceanbase-database-standalone/edit/V4.2.5/zh-CN/600.manage/600.backup-and-recovery/600.restore-data/800.parameters-of-the-restore.md)  

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

## 恢复命令相关

### 命令

- 恢复到指定时间戳

  ```sql
  ALTER SYSTEM RESTORE dest_tenant_name FROM uri UNTIL TIME='timestamp' WITH 'restore_option' [WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password'] [DESCRIPTION [=] description];

  ```
 - 恢复到指定 SCN

  ```sql
  ALTER SYSTEM RESTORE dest_tenant_name FROM uri UNTIL SCN=scn WITH 'restore_option' [WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password']  [DESCRIPTION [=] description];

  ```
 - 恢复到最新位点

  ```sql
  ALTER SYSTEM RESTORE dest_tenant_name FROM uri WITH 'restore_option' [WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password'] [DESCRIPTION [=] description];

  ```
 - 取消正在进行的租户恢复

  ```sql
  ALTER SYSTEM CANCEL RESTORE dest_tenant_name;

  ```

### 参数解释

| 参数 | 描述 |
| --- | --- |
| dest_tenant_name | 指恢复的新租户的名称。 |
| uri | 指备份时设置的数据备份路径 `backup_data_dest` 与日志归档路径 `log_archive_dest`，该值至少包含一条数据备份路径和一条日志归档路径，路径间用 `,` 分隔。 |
| timestamp | 指恢复指定时间戳，恢复到该时间点为止，且包括该 `timestamp` 位点，指定 `timestamp` 必须以 `=` 连接。`timestamp` 仅支持 `YYYY-MM-DD HH24:MI:SS.FF` 格式，并且小数部分（`FF`）支持 0~6 位小数，可以精确到微秒。 |
| scn | 指恢复指定的 SCN，恢复到该 SCN 位点为止，且包括该 `scn` 位点，指定 `scn` 须以 `=` 连接。 |
| restore_option | 支持指定 `pool_list`、`locality`、`primary_zone`、`concurrency`，不同参数之间通过 `&` 分隔。在指定 `locality` 和 `primary_zone` 时，建议尽量与源租户保持同构。如果不同构，待租户恢复后激活为主租户可能会产生负载均衡操作，影响性能。   - `pool_list`：必选，填写为待恢复的新租户创建的资源池。多个资源池之间用英文逗号（,）分隔。 - `locality`：可选，填写新租户副本分布的 Locality 信息，需要与新租户所在集群的 `pool_list` 的 Zone 信息相匹配。     与源租户保持同构时，建议新租户与源租户的 F 副本个数相同。      如果不指定，默认按照 `resource_pool` 的 `zone_list` 为每个 Zone 设一个 F 副本。     填写样例: `locality='F@z1,F@z2,F@z3'` - `primary_zone`：可选，指定新租户的 Leader 副本的偏好位置，需要与 `pool_list` 及 `locality` 相匹配，即需要满足 Zone 信息匹配以及 `primary_region` 内至少有两个 Paxos 成员等限制。     与源租户保持同构时，建议新租户与源租户的第一优先级的 Primary Zone 个数相同。     如果不指定，系统默认按照 `locality` 的 `zone_list` 将 Leader 随机分布在这些 Zone 中。      填写样例: `primary_zone='z1'` - `concurrency`：可选，指定数据恢复的并发度。如果不指定，则默认等于该租户被分配的 MAX_CPU 数。     填写样例：`concurrency=50`    #### 注意    OceanBase 集中式数据库中不需要指定 `locality` 和 `primary_zone` |
| WITH KEY FROM 'backup_key_path' ENCRYPTED BY 'password' | 指定加密租户的秘钥备份信息。仅当源租户配置了透明加密，才需要在恢复时指定秘钥备份相关的信息。其中：   - `backup_key_path`：秘钥的备份路径。 - `password`：备份秘钥时设置的加密密码。 |
| description | 为可选项，指用户指定的描述信息。 |

### timestamp 与 scn 选取约束

`timestamp` 与 `scn` 需要大于等于数据备份视图 `CDB_OB_BACKUP_SET_FILES` 中记录的数据备份的最小恢复位点 `MIN_RESTORE_SCN`，小于等于日志归档视图 `CDB_OB_ARCHIVELOG` 中的最大归档位点 `CHECKPOINT_SCN`。由于日志归档可能出现断流，因此恢复位点的选择还需要考虑日志归档的不连续区间，对于可恢复区间的选择则可能是分段的。

举例说明，假设用户的备份情况如下：

- 发起了 2 次日志归档，其中 `round_id` 分别为 1、2。
 - 发起了 3 次数据备份，有效数据备份分别为 `full_backup_set_1`、 `full_backup_set_2`、`inc_backup_set_3`。

物理恢复的可恢复区间如下图所示。其中，数据备份的右边界均为 `MIN_RESTORE_SCN`（例如，数据备份 `full_backup_set_1` 的 `MIN_RESTORE_SCN` 对应图中的 `scn 300`）；日志归档的右边界均为 `CHECKPOINT_SCN`（例如，日志备份 `round 1` 的 `CHECKPOINT_SCN` 对应图中的 `scn 500`）。

![可恢复区间](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.1.0/user-guide/backup-and-restore/restore-window.jpg)

由于日志归档可能发生中断，故在计算恢复区间时还需要排除中间不连续的时间段，这样就会呈现出分段的可恢复区间，即图中大括号划出的范围：`[scn 300, scn 500] \∪ [scn 900, scn 1500]`。

## 恢复性能相关

### 命令

```sql
ALTER SYSTEM SET ha_high_thread_score =10 TENANT = mysql;

```

### 参数解释

| 参数 | 描述 |
| --- | --- |
| ha_high_thread_score | 设置恢复任务队列使用的线程数。 |

## Recover 命令相关

### 命令

- 回放到日志到指定的时间戳，且包含该时间戳位点。

  ```sql
  ALTER SYSTEM RECOVER STANDBY [TENANT [=] tenant_name] UNTIL TIME='timestamp';

  ```
 - 回放到日志到指定的 scn，且包含该 scn 位点。

  ```sql
  ALTER SYSTEM RECOVER STANDBY [TENANT [=] tenant_name] UNTIL SCN=scn;

  ```
 - 无终点，持续回放归档源端日志。

  ```sql
  ALTER SYSTEM RECOVER STANDBY [TENANT [=] tenant_name] UNTIL UNLIMITED;

  ```
 - 取消 Recover。

  ```sql
  ALTER SYSTEM RECOVER STANDBY TENANT [=] tenant_name CANCEL;

  ```

### 参数解释

| 参数 | 描述 |
| --- | --- |
| tenant_name | 租户名 |
| timestamp | 指恢复指定时间戳，恢复到该时间点为止，且包括该 `timestamp` 位点，指定 `timestamp` 必须以 `=` 连接。`timestamp` 仅支持 `YYYY-MM-DD HH24:MI:SS.FF` 格式，并且小数部分（`FF`）支持 0~6 位小数，可以精确到微秒。 |
| scn | 指恢复指定的 SCN，恢复到该 SCN 位点为止，且包括该 `scn` 位点，指定 `scn` 须以 `=` 连接。 |
| UNLIMITED | 无终点恢复，持续回放归档源端日志。 |

## ACTIVATE STANDBY 命令相关

### 命令

```sql
ALTER SYSTEM ACTIVATE STANDBY TENANT tenant_name;

```

### 参数解释

| 参数 | 描述 |
| --- | --- |
| tenant_name | 恢复成功的备租户名。当前每条命令仅支持切换一个租户。 |

 上一篇 下一篇 ![有帮助](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) 咨询热线