--- title: "设置租户最大连接数 - OceanBase 数据库 V4.5.0 | OceanBase 文档中心" description: 设置租户最大连接数 由于连接会占用一定的资源，大量的长连接会影响小规格租户的稳定性，OceanBase 数据库支持通过配置项或系统变量为租户设置最大连接数。 与租户最大连接数相关的配置项或变量如下： max_connections 系统变量 max_connections 用于控制整个租户的最大连接数，当前仅 MyS… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.5.0 # 设置租户最大连接数 更新时间：2026-04-01 11:01:14 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/700.reference/1200.database-proxy/1700.set-the-maximum-connections.md) 由于连接会占用一定的资源，大量的长连接会影响小规格租户的稳定性，OceanBase 数据库支持通过配置项或系统变量为租户设置最大连接数。 与租户最大连接数相关的配置项或变量如下： - `max_connections` 系统变量 `max_connections` 用于控制整个租户的最大连接数，当前仅 MySQL 模式支持该系统变量。其默认值为 `2147483647`，取值范围为 [1,2147483647]。该变量修改后，需要重启 OBServer 节点才能生效。 - `max_user_connections` 系统变量 `max_user_connections` 用于控制租户内单个用户的最大并发连接数，当前仅 MySQL 模式支持该系统变量。其默认值为 `0`，表示不限制连接数；当值大于 `0` 时，以实际设置的值为准，取值范围为 [0,4294967295]。该变量修改后，需要重启 OBServer 节点才能生效。 - `_resource_limit_max_session_num` 租户级隐藏配置项 `_resource_limit_max_session_num` 用于控制用户租户内普通用户的最大并发连接数，该配置项修改后立即生效，不需要重启 OBServer 节点。其默认值为 `0`，取值范围为 [0,1000000]。该配置项一般不需要修改。 当隐藏配置项 `_resource_limit_max_session_num` 的值大于 `0` 时，以实际设置的值为准；当隐藏配置项 `_resource_limit_max_session_num` 的值为 `0` 时，系统内部会自动按照一定的规则计算出最大连接数。具体计算规则如下： 用户租户并发连接数上限 = MAX（100, 租户实际内存 * 5%/（100 KB）） 其中: - 租户实际内存：创建租户时分配的资源池中资源单元的内存（`memory_size`）减去对应 Meta 租户的内存后的值。用户租户与其对应的 Meta 租户的内存分配说明，参见 [租户内部内存管理](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004476330)。 - `100`：连接数下限。 - `100 KB`：根据经验计算出的单个会话可能占用的内存。 根据该算法，如果用户租户的内存规格（`memory_size`）为 3 GB，对应 Meta 租户的内存为 1 GB，则租户实际内存为 `3 GB - 1 GB = 2 GB`，则该租户的最大连接数为 `MAX（100, 2 GB * 5%/（100 KB））= 1000`。 ## 注意事项 在 OceanBase 数据库中，名称以 "_" 开头的配置项称为隐藏配置项，仅供开发人员在故障排查或紧急运维时使用。 ## 使用限制 - 仅 MySQL 租户可通过系统变量 `max_connections` 和 `max_user_connections` 调整租户或租户内用户的最大连接数。 - 为了防止因出现大量长连接而导致的运维人员无法登录的问题，配置项 `_resource_limit_max_session_num` 的值对 `sys` 租户或用户租户的管理员用户（MySQL 模式默认为 `root` 用户，Oracle 模式默认为 `SYS` 用户）不受限。 ## MySQL 租户查看本租户的最大连接数 1. 租户管理员登录到集群的 MySQL 租户。 2. 查看租户的最大连接数。 - 查看整个租户的最大连接数 ```shell obclient> SHOW VARIABLES LIKE 'max_connections'; ``` 或者 ```shell obclient> SELECT * FROM INFORMATION_SCHEMA.SESSION_VARIABLES WHERE VARIABLE_NAME = 'max_connections'; ``` 查询结果如下： ```shell +-----------------+------------+ | Variable_name | Value | +-----------------+------------+ | max_connections | 2147483647 | +-----------------+------------+ 1 row in set ``` - 查看租户内单个用户的最大并发连接数 ```shell obclient> SHOW VARIABLES LIKE 'max_user_connections'; ``` 或者 ```shell obclient> SELECT * FROM INFORMATION_SCHEMA.SESSION_VARIABLES WHERE VARIABLE_NAME = 'max_user_connections'; ``` 查询结果如下： ```shell +----------------------+-------+ | Variable_name | Value | +----------------------+-------+ | max_user_connections | 0 | +----------------------+-------+ 1 row in set ``` - 查看租户内普通用户总的最大并发连接数 ```shell obclient> SELECT * FROM oceanbase.GV$OB_PARAMETERS WHERE NAME LIKE '_resource_limit_max_session_num'; ``` #### 说明 隐藏配置项在未修改前（即为默认值）无法通过 `SHOW` 语句查询，只能通过 `GV$OB_PARAMETERS` 视图查询。如果该隐藏配置项已经被修改为非默认值，则可以通过 `SHOW` 语句查询。 查询结果如下： ```shell +----------------+----------+-------+--------+-----------+---------------------------------+-----------+-------+-----------------------------------------------------------------+----------------+-------------------+---------------+-----------+ | SVR_IP | SVR_PORT | ZONE | SCOPE | TENANT_ID | NAME | DATA_TYPE | VALUE | INFO | SECTION | EDIT_LEVEL | DEFAULT_VALUE | ISDEFAULT | +----------------+----------+-------+--------+-----------+---------------------------------+-----------+------- +-----------------------------------------------------------------+----------------+-------------------+---------------+-----------+ | 172.xx.xxx.xxx | 2882 | zone1 | TENANT | 1004 | _resource_limit_max_session_num | INT | 0 | the maximum number of sessions that can be created concurrently | RESOURCE_LIMIT | DYNAMIC_EFFECTIVE | 0 | YES | +----------------+----------+-------+--------+-----------+---------------------------------+-----------+-------+-----------------------------------------------------------------+----------------+-------------------+---------------+-----------+ 1 row in set ``` 查询结果中，`VALUE` 列对应的值即为对应的配置项的值。 有关视图 `GV$OB_PARAMETERS` 的更多介绍，请参见 [GV$OB_PARAMETERS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477966)。 3. 设置租户的最大连接数。 - 设置整个租户的最大连接数 ```shell obclient> SET GLOBAL max_connections = 1000; ``` 执行成功后，需要重启 OBServer 节点才能生效。 - 设置租户内单个用户的最大并发连接数 ```shell obclient> SET GLOBAL max_user_connections = 50; ``` 执行成功后，需要重启 OBServer 节点才能生效。 - 设置租户内普通用户总的最大并发连接数 ```shell obclient> ALTER SYSTEM SET _resource_limit_max_session_num = 100; ``` #### 说明 如果当前租户同时设置了`_resource_limit_max_session_num`、`max_user_connections` 和 `max_connections` 的值，则对于某个普通用户，其并发连接数只要达到其中一个值，即无法再建立新的连接；对于管理员用户，其并发连接数只要达到 `max_user_connections` 或 `max_connections` 的其中一个值，即无法再建立新的连接。 ## Oracle 租户查看本租户相关的最大并发连接数 1. 租户管理员登录到集群的 Oracle 租户。 2. 通过视图查看租户内普通用户的最大并发连接数。 ```shell obclient> SELECT * FROM SYS.GV$OB_PARAMETERS WHERE NAME LIKE '_resource_limit_max_session_num'; ``` 查询结果如下： ```shell +----------------+----------+-------+--------+-----------+---------------------------------+-----------+-------+-----------------------------------------------------------------+----------------+-------------------+---------------+-----------+ | SVR_IP | SVR_PORT | ZONE | SCOPE | TENANT_ID | NAME | DATA_TYPE | VALUE | INFO | SECTION | EDIT_LEVEL | DEFAULT_VALUE | ISDEFAULT | +----------------+----------+-------+--------+-----------+---------------------------------+-----------+-------+-----------------------------------------------------------------+----------------+-------------------+---------------+-----------+ | 172.xx.xxx.xxx | 2882 | zone1 | TENANT | 1004 | _resource_limit_max_session_num | INT | 0 | the maximum number of sessions that can be created concurrently | RESOURCE_LIMIT | DYNAMIC_EFFECTIVE | 0 | YES | +----------------+----------+-------+--------+-----------+---------------------------------+-----------+-------+-----------------------------------------------------------------+----------------+-------------------+---------------+-----------+ 1 row in set ``` 有关视图 `GV$OB_PARAMETERS` 的更多介绍，请参见 [GV$OB_PARAMETERS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004477966)。 3. 设置租户内普通用户的最大并发连接数。 ```shell obclient> ALTER SYSTEM SET "_resource_limit_max_session_num" = 100; ``` ## 相关文档 关于配置项和变量的更多介绍，请参见如下信息： - [设置参数](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004476346) - [设置变量](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004476347) - [查看租户会话](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004475783) - [终止租户会话](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004475785) 上一篇 下一篇 ![有帮助](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) 咨询热线