---
title: 如何在 SYS 租户中设置普通租户的配置项与全局变量-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于如何在 SYS 租户中设置普通租户的配置项与全局变量相关的常见问题和使用技巧，帮助您快速解决如何在 SYS 租户中设置普通租户的配置项与全局变量的难题。
---
切换语言

- 简体中文
- English

划线反馈

# 如何在 SYS 租户中设置普通租户的配置项与全局变量

更新时间：2026-06-10 01:56

适用版本： V2.1.x、V2.2.x、V3.1.x、V3.2.x 内容类型：How-to  

我们可以在 SYS 租户中设置 OceanBase 数据库的配置项（参数），包括集群级的配置项和租户级的配置项。对于租户的全局变量的设置，我们一般是在各个租户下单独设置。事实上，我们也可以在 SYS 租户中对业务租户的全局变量进行设置管理。

## 适用版本

OceanBase 数据库 V2.x、V3.x 版本。

## 查看与设置集群配置项

集群配置项只能在 SYS 租户中进行设置。

```shell
obclient> SHOW PARAMETERS LIKE 'CPU_COUNT';
obclient> ALTER SYSTEM SET CPU_COUNT=10;

```

## 在 SYS 租户中查看与设置业务租户的配置项

```shell
obclient> SHOW PARAMETERS LIKE 'writing_throttling_trigger_percentage' tenant=mysql;
obclient> ALTER SYSTEM SET writing_throttling_trigger_percentage=90 tenant=mysql;

```

## 在业务租户中查看和设置业务租户的配置项和全局变量

```shell
obclient> SHOW PARAMETERS LIKE 'writing_throttling_trigger_percentage';
obclient> ALTER SYSTEM SET writing_throttling_trigger_percentage=90;

obclient> SHOW GLOBAL VARIABLES LIKE 'ob_query_timeout';
obclient> SET GLOBAL ob_query_timeout=20000000;

```

在业务租户中设置租户的配置项，不能在 ALTER SYSTEM 命令中指定租户，比如：

```shell
obclient [(none)]> SHOW PARAMETERS LIKE 'writing_throttling_trigger_percentage' tenant=mysql;
ERROR 1227 (42501): Access denied

obclient [(none)]> ALTER SYSTEM SET writing_throttling_trigger_percentage=100 tenant=mysql;
ERROR 1227 (42501): Access denied

```

## 在 SYS 租户中查看与设置业务租户的全局变量

使用 ALTER SYSTEM CHANGE TENANT 命令。

登录 SYS 租户，查看当前 session 变量 `ob_query_timeout = 10000000`。

```shell
obclient [oceanbase]> SHOW VARIABLES LIKE 'ob_query_timeout';
+------------------+----------+
| Variable_name    | Value    |
+------------------+----------+
| ob_query_timeout | 10000000 |
+------------------+----------+

```

使用 CHANGE TENANT 命令把租户从 sys 切换到 mysql。

```shell
obclient [oceanbase]> ALTER SYSTEM CHANGE TENANT mysql;
Query OK, 0 rows affected (0.00 sec)

obclient [oceanbase]> SHOW TENANT;
+---------------------+
| Current_tenant_name |
+---------------------+
| mysql               |
+---------------------+
1 row in set (0.03 sec)

```

设置 mysql 租户的全局变量 `ob_query_timeout=20000000`。

```shell
obclient [oceanbase]> SET GLOBAL ob_query_timeout=20000000;
Query OK, 0 rows affected (0.01 sec)

obclient [oceanbase]> show global variables like 'ob_query%';
+------------------+----------+
| Variable_name    | Value    |
+------------------+----------+
| ob_query_timeout | 20000000 |
+------------------+----------+
1 row in set (0.00 sec)

```

session 变量的 ob_query_timeout 没有变化，依然是 10000000，因为 session 还是连接 sys 租户的 connection。

```shell
obclient [oceanbase]> show variables like 'ob_query%';
+------------------+----------+
| Variable_name    | Value    |
+------------------+----------+
| ob_query_timeout | 10000000 |
+------------------+----------+
1 row in set (0.00 sec)

```

Previous

[OceanBase 数据库中都有哪些内部租户](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000450156)

Next

[设置租户变量 max_connections 无效](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000207666) ![有帮助](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) 咨询热线