查看数据备份相关参数

查看数据备份相关参数

更新时间：2026-04-06 12:56:14

编辑

执行备份操作后，您可以查看备份相关参数的配置信息。

系统租户查看用户租户的数据备份相关参数

使用 root 用户登录集群的 sys 租户。
分别执行以下语句，查看备份相关的参数配置信息。
- 查看备份、备份清理等高可用低优先级任务的当前工作线程数。
  
  示例如下：
```
obclient(root@sys)[(none)]> SHOW PARAMETERS LIKE '%ha_low_thread_score%'\G
```
  查询结果如下：
```
*************************** 1. row ***************************
         zone: zone1
     svr_type: observer
       svr_ip: 172.xx.xxx.xxx
     svr_port: 2882
         name: ha_low_thread_score
    data_type: INT
        value: 0
         info: the current work thread score of high availability low thread. Range: [0,100] in integer. Especially, 0 means default value
      section: OBSERVER
        scope: TENANT
       source: DEFAULT
   edit_level: DYNAMIC_EFFECTIVE
default_value: 0
    isdefault: 1
1 row in set
```
  租户级配置项 ha_low_thread_score 用于指定备份、备份清理等高可用低优先级任务的当前工作线程数，默认值为 0。如果发现数据备份的任务运行速度过慢，您可以适当提高配置项 ha_low_thread_score 的值，建议每次将数值翻倍。有关配置项 ha_low_thread_score 的详细说明，参见 ha_low_thread_score。
  
  设置备份时写文件系统的并发数的示例如下：
```
obclient(root@sys)[(none)]> ALTER SYSTEM SET ha_low_thread_score = 4 TENANT = mysql_tenant;
```
  示例中，通过配置项 ha_low_thread_score 的值设置为 4，表示该租户（mysql_tenant）备份任务的工作线程数是 4。
- 查看租户下的备份参数信息（不含源端配置信息）。
  
  视图 oceanbase.CDB_OB_BACKUP_PARAMETER 记录了当前集群中所有租户配置的备份参数信息。
```
obclient(root@sys)[oceanbase]> SELECT * FROM oceanbase.CDB_OB_BACKUP_PARAMETER\G
```
  查询结果的示例如下：
```
*************************** 1. row ***************************
TENANT_ID: 1004
     NAME: data_backup_dest
    VALUE: oss://oceanbase-test-bucket/backup/data/?host=xxx.aliyun-inc.com&access_id=xxx&access_key=xxx&delete_mode=delete&checksum_type=md5&enable_worm=true
1 row in set
```
  本示例中，TENANT_ID 为 1004 的租户的数据备份路径（data_backup_dest）为 oss://oceanbase-test-bucket/backup/data/?host=xxx.aliyun-inc.com&access_id=xxx&access_key=xxx，同时其备份文件的清理模式（delete_mode）为 delete。其中，delete_mode 主要有以下两种模式：
  - delete 模式：表示清理模式为直接删除满足要求的备份文件。
    
    该模式下，当您清理备份文件时，对于满足清理要求的备份文件，系统会直接将其删除。
  - tagging 模式：表示清理模式为对满足清理要求的备份文件设置 Tag，备份文件将仍然保留。
    
    该模式下，当您清理备份文件时，对于满足清理要求的备份文件，系统会给这些文件设置标签，标签的 key 为 "delete_mode"，value 为 "tagging"，以便后续您可以通过设置的标签在 OSS 或 AWS S3 上对这些文件的生命周期进行管理。
  此外，在该租户备份路径的参数中，checksum_type=md5 表示使用 MD5 算法校验备份文件的完整性；enable_worm=true 表示 OceanBase 数据库按照 WORM 的规范对该路径执行写入与删除操作。
- 查看租户下备份路径的配置相关信息（含源端配置信息）。
  
  视图 CDB_OB_BACKUP_STORAGE_INFO 中记录了所有租户备份或归档路径的配置相关信息。
```
obclient(root@sys)[oceanbase]> SELECT TENANT_ID, PATH, DEST_TYPE, EXTENSION, MAX_IOPS, MAX_BANDWIDTH, MAX_BANDWIDTH_DISPLAY FROM oceanbase.CDB_OB_BACKUP_STORAGE_INFO WHERE DEST_TYPE='backup_data';
```
  查询结果的示例如下：
```
+-----------+---------------------------------------------+-------------+-----------------------------------------------+----------+---------------+-----------------------+
| TENANT_ID | PATH                                        | DEST_TYPE   | EXTENSION                                     | MAX_IOPS | MAX_BANDWIDTH | MAX_BANDWIDTH_DISPLAY | 
+-----------+---------------------------------------------+-------------+-----------------------------------------------+----------+---------------+-----------------------+
|      1004 | oss://oceanbase-test-bucket/backup/data     | backup_data | checksum_type=md5&enable_worm=true&zone=zone1 |     1000 |             0 | UNLIMITED             |
+-----------+---------------------------------------------+-------------+-----------------------------------------------+----------+---------------+-----------------------+
1 row in set
```
  查询结果中，对于租户 ID 为 1004 的租户，其备份路径为 oss://oceanbase-test-bucket/backup/data；checksum_type=md5 表示使用 MD5 算法校验备份文件的完整性；enable_worm=true 表示 OceanBase 数据库按照 WORM 的规范对该路径执行写入与删除操作；源端配置为 zone=zone1，表示仅 zone1 的节点可以访问该路径。I/O 限流方面，MAX_IOPS 为 1000，表示当前备份路径每秒最多允许约 1000 次 I/O 请求；MAX_BANDWIDTH_DISPLAY 为 UNLIMITED，表示不限制带宽。

用户租户查看本租户的数据备份相关参数

租户管理员登录到数据库。

说明

MySQL 租户的管理员用户为 root 用户，Oracle 租户的管理员用户为 SYS 用户。

分别执行以下语句，查看备份相关的参数配置信息。

查看备份、备份清理等高可用低优先级任务的当前工作线程数。

示例如下：
```
obclient(root@mysql001)[(none)]> SHOW PARAMETERS LIKE '%ha_low_thread_score%'\G
```
查询结果如下：
```
*************************** 1. row ***************************
         zone: zone1
     svr_type: observer
       svr_ip: 172.xx.xxx.xxx
     svr_port: 2882
         name: ha_low_thread_score
    data_type: INT
        value: 0
         info: the current work thread score of high availability low thread. Range: [0,100] in integer. Especially, 0 means default value
      section: OBSERVER
        scope: TENANT
       source: DEFAULT
   edit_level: DYNAMIC_EFFECTIVE
default_value: 0
    isdefault: 1
1 row in set
```
租户级配置项 ha_low_thread_score 用于指定备份、备份清理等高可用低优先级任务的当前工作线程数，默认值为 0。如果发现数据备份的任务运行速度过慢，您可以适当提高配置项 ha_low_thread_score 的值，建议每次将数值翻倍。有关配置项 ha_low_thread_score 的详细说明，参见 ha_low_thread_score。

用户租户设置本租户备份时写文件系统的并发数的示例如下：
```
obclient(root@mysql001)[(none)]> ALTER SYSTEM SET ha_low_thread_score = 4;
```
示例中，通过配置项 ha_low_thread_score 的值设置为 4，表示当前租户备份任务的工作线程数是 4。

查看本租户的备份参数信息（不含源端配置信息）。

用户租户可以通过 oceanbase.DBA_OB_BACKUP_PARAMETER 视图（MySQL 模式）或 SYS.DBA_OB_BACKUP_PARAMETER 视图（Oracle 模式）查看本租户配置的备份参数信息。

MySQL 模式

Oracle 模式

MySQL 模式下的查询示例如下：

obclient(root@mysql001)[oceanbase]> SELECT * FROM oceanbase.DBA_OB_BACKUP_PARAMETER;

Oracle 模式下的查询示例如下：

obclient(SYS@oracle001)[SYS]> SELECT * FROM SYS.DBA_OB_BACKUP_PARAMETER;

查询结果的示例如下：

+------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
| NAME             | VALUE                                                                                                                                                 |
+------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
| data_backup_dest | oss://oceanbase-test-bucket/backup/data/?host=xxx.aliyun-inc.com&access_id=xxx&access_key=xxx&delete_mode=delete&checksum_type=md5&enable_worm=true   |
+------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
1 row in set

根据查询结果，在当前租户备份路径的参数中，checksum_type=md5 表示使用 MD5 算法校验备份文件的完整性；enable_worm=true 表示 OceanBase 数据库按照 WORM 的规范对该路径执行写入与删除操作。

查看本租户备份路径的配置相关信息（含源端配置信息）。

用户租户可以通过 oceanbase.DBA_OB_BACKUP_STORAGE_INFO 视图（MySQL 模式）或 SYS.DBA_OB_BACKUP_STORAGE_INFO 视图（Oracle 模式）查看本租户备份或归档路径的配置相关信息。