---
title: "PARAMETER - OceanBase 数据库 V4.2.1 | OceanBase 文档中心"
description: "PARAMETER 描述 ALTER SYSTEM [SET] parameter_name = expression 语句用于修改配置项的值。 OceanBase 数据库的配置项分为集群级配置项和租户级配置项。集群级配置项的作用范围包含整个集群的所有节点；租户级配置项的作用范围为当前租户所在的所有节点。有关配置项的…"
---
切换语言

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

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

# PARAMETER

更新时间：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/2600.PARAMETER.md)  

## 描述

`ALTER SYSTEM [SET] parameter_name = expression` 语句用于修改配置项的值。

OceanBase 数据库的配置项分为集群级配置项和租户级配置项。集群级配置项的作用范围包含整个集群的所有节点；租户级配置项的作用范围为当前租户所在的所有节点。有关配置项的更多介绍，请参见 [配置项和系统变量概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218230)。

## 使用限制及注意事项

- 仅 `sys` 租户可以修改集群级配置项，用户租户不能修改集群级配置项。
 - Oracle 模式下设置 `ALTER SYSTEM SET XXX='True'/'False';` 有以下调整：

     - 在 V4.2.1 BP5 之前版本，`True/False` 必须加上单引号才能配置。
     - 在 V4.2.1 BP5 及之后版本，`True/False` 加不加引号都可配置。
 - 配置项的生效方式一般分为动态生效和重启生效两种，大部分配置项为动态生效方式，即不需要重启 OBServer 节点即可生效。修改配置项前，可通过 `SHOW PARAMETERS LIKE` 语句确认配置项的生效方式。查看配置项生效方式的详细操作，请参见 [集群配置项](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218081)。

## 权限要求

执行 `ALTER SYSTEM [SET] parameter_name = expression` 语句需要当前用户拥有 `ALTER SYSTEM` 权限。有关 OceanBase 数据库权限的详细介绍，请参见 [MySQL 模式下的权限分类](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220876) 和 [Oracle 模式下的权限分类](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220864)。

## 语法

```sql
ALTER SYSTEM [SET] alter_system_set_parameter_actions;

alter_system_set_parameter_actions:
alter_system_set_parameter_action [, alter_system_set_parameter_action...]

alter_system_set_parameter_action:
parameter_name = expression [COMMENT [=] 'text'] [SCOPE = {MEMORY | SPFILE | BOTH}] [SERVER [=] 'ip:port' | ZONE [=] 'zone_name' | TENANT [=] {sys | all_user | all | all_meta | tenant_name}]

```

## 参数说明

| **参数** | **描述** |
| --- | --- |
| parameter_name | 指定待修改的配置项名称。 |
| expression | 指定修改后的配置项的值。 |
| COMMENT | 添加关于本次修改的注释。该参数为可选，建议不要省略。 |
| SCOPE | 指定本次配置项修改的生效范围，主要有以下三种：   - `MEMORY`：表示仅修改内存中的配置项值，修改后立即生效，且本次修改在 OBServer 节点重启以后会失效（当前暂无配置项支持该方式）。 - `SPFILE`：表示仅修改配置表中的配置项值，需要 OBServer 节点重启以后才生效。 - `BOTH`：表示既修改配置表，又修改内存值，修改后立即生效，且 OBServer 节点重启后配置项的值仍然生效。     `SCOPE` 的默认值为 `BOTH`。 |
| SERVER | 指定集群中待修改配置项值的 OBServer 节点，仅支持指定一个 OBServer 节点。 |
| ZONE | 指定集群中待修改配置项值的 Zone，仅支持指定一个 Zone。指定后，本次修改对该 Zone 内的所有 OBServer 节点生效。不能同时指定 Zone 和 Server。 |
| TENANT | 系统租户指定待修改租户级配置项值的租户，如果不指定，默认为本租户。其中：   - `sys`：指定修改系统租户的配置项值。 - `all_user`、`all`：指定修改所有用户租户的配置项值。     #### 说明      OceanBase 数据库从 V4.2.1 版本开始，`TENANT = all_user` 与 `TENANT = all` 语义相同，在需要修改所有用户租户的配置项值时，推荐使用 `TENANT = all_user`，后续 `TENANT = all` 将废弃不再使用。 - `all_meta`：指定修改所有 Meta 租户的配置项值。 - `tenant_name`：指定某个租户，每次仅支持指定一个租户。     仅通过 `sys` 租户修改指定租户的租户级配置项时需要添加该子句。有关租户级配置项的清单，请参见 [租户级别配置项](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218691)。 |

## 示例

- 系统租户修改集群级配置项 `enable_sql_audit` 的值。

  ```sql
  obclient [oceanbase]> ALTER SYSTEM SET ENABLE_SQL_AUDIT = False SCOPE = BOTH;

  ```
 - 系统租户修改租户 `tenant` 的租户级配置项 `connection_control_max_connection_delay` 的值。

  ```sql
  obclient [oceanbase]> ALTER SYSTEM SET connection_control_max_connection_delay = 2147483646 TENANT = tenant;

  ```
 - 系统租户修改集群中所有租户（含sys 租户、用户租户、Meta 租户）的租户级配置项 `major_freeze_duty_time` 的值。

  需要在系统租户下依次执行以下命令：

  ```sql
  obclient [oceanbase]> ALTER SYSTEM SET major_freeze_duty_time='01:00' TENANT = sys;

  ```

  ```sql
  obclient [oceanbase]> ALTER SYSTEM SET major_freeze_duty_time='01:00' TENANT = all_user;

  ```

  ```sql
  obclient [oceanbase]> ALTER SYSTEM SET major_freeze_duty_time='01:00' TENANT = all_meta;

  ```
 - 用户租户修改本租户的租户级配置项 `major_freeze_duty_time` 的值。

  ```sql
  obclient [oceanbase]> ALTER SYSTEM SET major_freeze_duty_time='01:00';

  ```

## 相关文档

- [设置参数](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218484)
 - [配置项和系统变量概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218230)

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