---
title: "BACKUP CLUSTER PARAMETERS - OceanBase 数据库 V4.2.1 | OceanBase 文档中心"
description: BACKUP CLUSTER PARAMETERS ALTER SYSTEM BACKUP CLUSTER PARAMETERS 语句用于备份集群级配置项。 使用限制及注意事项 对于 V4.2.1 版本，从 V4.2.1 BP10 版本开始支持该语句。 该语句仅支持在 sys 租户的 root 用户下执行。 该语句仅…
---
切换语言

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

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

# BACKUP CLUSTER PARAMETERS

更新时间：2026-04-16 00:11:36

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.1/zh-CN/700.reference/500.sql-reference/100.sql-syntax/100.system-tenants/200.alter-system/620.backup-cluster-parameters.md)  

`ALTER SYSTEM BACKUP CLUSTER PARAMETERS` 语句用于备份集群级配置项。

## 使用限制及注意事项

- 对于 V4.2.1 版本，从 V4.2.1 BP10 版本开始支持该语句。
 - 该语句仅支持在 `sys` 租户的 `root` 用户下执行。
 - 该语句仅备份非默认设置的集群范围的配置项。

  #### 注意

  对于 `all_server_list`、`rootservice_list` 和 `debug_sync_timeout` 等配置项，无论其值是否为默认值，均不会备份。

## 语法

```sql
ALTER SYSTEM BACKUP CLUSTER PARAMETERS TO 'parameters_backup_path';

```

## 参数说明

| 参数 | 描述 |
| --- | --- |
| parameters_backup_path | 集群级配置项备份文件的目标路径，需要用户自行指定。其路径要求与数据备份的备份目的端路径要求一致。有关数据备份的备份目的端要求，参见 [备份前准备](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218409)。 |

## 示例

将集群级配置项备份至 `oss://oceanbase-test-bucket/backup/cluster_parameters?host=***.aliyun-inc.com&access_id=***&access_key=***` 目录下。

```shell
obclient> ALTER SYSTEM BACKUP CLUSTER PARAMETERS TO 'oss://oceanbase-test-bucket/backup/cluster_parameters?host=***.aliyun-inc.com&access_id=***&access_key=***';

```

## 相关文档

[备份配置项](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001667656)

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