---
title: "修改租户参数 | OceanBase 文档中心"
description: 修改租户参数 您可以通过 SQL 语句或 OCP 修改租户参数。 通过 SQL 语句修改租户参数 租户参数即租户级配置项，系统租户（即 sys 租户）和普通租户都可以设置租户级配置项。系统租户可以设置本租户和其他租户的租户级配置项，普通租户只能设置本租户的租户级配置项。 设置租户级配置项的语法如下： ALTER SY…
---
切换语言

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

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

# 修改租户参数

更新时间：2026-06-10 11:22:35

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V3.1.5/zh-CN/100.users-guide/600.basic-database-management/400.manage-tenants/1300.manage-tenant-parameters/300.modify-tenant-parameters.md)  

您可以通过 SQL 语句或 OCP 修改租户参数。

## 通过 SQL 语句修改租户参数

租户参数即租户级配置项，系统租户（即 `sys` 租户）和普通租户都可以设置租户级配置项。系统租户可以设置本租户和其他租户的租户级配置项，普通租户只能设置本租户的租户级配置项。

设置租户级配置项的语法如下：

```sql
ALTER SYSTEM [SET] parameter_name = expression [SCOPE = {MEMORY | SPFILE | BOTH}]
  [COMMENT [=] 'text']
     [SERVER [=] 'ip:port' | ZONE [=] 'zone']
         [TENANT=all|TENANT_NAME];

```

语句使用说明：

- `expression` 用于指定修改后该配置项的值。
 - `SCOPE` 用于指定本次配置项修改的生效范围，默认值为 `BOTH`。其中：

     - `MEMORY`：表示仅修改内存中的配置项，修改立即生效，且本修改在 OBServer重启以后会失效（当前暂无配置项支持这种方式）。
     - `SPFILE`：表示仅修改配置表中的配置项值，当OBServer重启以后才生效。
     - `BOTH`：表示既修改配置表，又修改内存值，修改后立即生效，且 Server 重启以后配置值仍然生效。
 - `SERVER` 表示指定租户中要修改的OBServer，`ZONE` 表示指定租户中要修改的 Zone。

  `ALTER SYSTEM` 语句不能同时指定 Zone 和 Server。并且在指定 Zone 时，仅支持指定一个 Zone；指定 Server 时，仅支持指定一个 Server。

  如果修改租户级配置项时，不指定 Zone 也不指定 Server，则表示该修改在整个租户内生效。
 - `TENANT=all | TENANT_NAME` 子句用于系统租户修改其他租户或所有租户的配置项值，仅系统租户可以执行该子句。

示例如下：

- 系统租户设置租户 `mytenant` 的配置项。

  ```sql
  obclient> ALTER SYSTEM SET clog_max_unconfirmed_log_count=1600 TENANT='mytenant';

  ```
 - 系统租户设置本租户的配置项。

  ```sql
  obclient> ALTER SYSTEM SET clog_max_unconfirmed_log_count=1600;

  ```
 - 普通租户的租户管理员设置本租户的配置项。

  ```sql
  obclient> ALTER SYSTEM SET clog_max_unconfirmed_log_count=1600 SCOPE=SPFILE;

  obclient> ALTER SYSTEM SET clog_max_unconfirmed_log_count=1600;

  obclient> ALTER SYSTEM SET clog_max_unconfirmed_log_count=1600 SERVER='xx.xx.xx.xx:2882';

  obclient> ALTER SYSTEM SET clog_max_unconfirmed_log_count=1600 ZONE='z1';

  ```

## 通过 OCP 修改租户参数

您也可以在 OCP 上修改租户参数。

### 前提条件

在修改租户参数前，请确认当前登录用户已具备租户管理权限。如果当前用户没有租户管理的权限，请联系管理员为您添加相应权限的角色，具体操作方法请参见 OCP 对应版本的《用户指南》文档中的 **编辑用户** 。

### 操作步骤

1. 登录 OCP 。
 2. 在左侧导航栏上，单击 **租户** 。
 3. 在 **租户列表** 区域，选择待操作的租户并单击其租户名。
 4. 在显示的页面的左侧导航栏上，单击 **参数管理** 。
 5. （可选）在 **参数列表** 页面上方的搜索框中，输入参数名相关信息进行模糊搜索。
 6. 找到待修改的参数，单击 **修改值** 按钮。

   ![09071422](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0660562361/p324249.png)
 7. 在弹出的对话框中，修改参数的值。

   ![09071420](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/0660562361/p324245.png)
 8. 单击 **提交** 。

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