---
title: "会话连接池 - 数据库代理  V4.3.5 | OceanBase 文档中心"
description: 会话连接池 背景信息 ODP 自 V4.3.5 起支持会话级连接池功能，以应对业务在短连接场景下频繁与 ODP 新建连接，导致 ODP 频繁与多个 OBServer 节点建连带来的开销，提升业务短连接场景的并发性能。 注意事项 当出现以下任一情况时，会话连接池不可用。 客户端使用了 Service Name，Serv…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*nSAhQbrBXKwAAAAAAAAAAAAADiGDAQ/original) 数据库代理 V 4.3.5

# 会话连接池

更新时间：2026-07-22 16:50:58

[编辑](https://github.com/oceanbase/oceanbase-proxy-doc/edit/V4.3.5/zh-CN/500.connection-management/500.session-connection-pool.md)  

## 背景信息

ODP 自 V4.3.5 起支持会话级连接池功能，以应对业务在短连接场景下频繁与 ODP 新建连接，导致 ODP 频繁与多个 OBServer 节点建连带来的开销，提升业务短连接场景的并发性能。

## 注意事项

当出现以下任一情况时，会话连接池不可用。

- 客户端使用了 Service Name，Service Name 的具体介绍可参见 [主备租户自动路由与读写分离](https://www.oceanbase.com/docs/common-odp-doc-cn-1000000003575298)。
 - ODP 配置项 `server_protocol` 值为 `compressed mysql`，可执行 `show proxyconfig like 'server_protocol';` 命令查看 `server_protocol` 配置项的值。
 - 客户端为 Oracle 租户。
 - 客户端开启过分布式事务。
 - 客户端与 ODP 间使用了 OceanBase 2.0 协议。
 - 客户端使用了 SSL。
 - 客户端请求为 BINLOG 请求。

## 版本限制

使用该功能需保证所用 ODP 为 V4.3.5 或之后版本，OceanBase 数据库为 V4.4.0 或之后版本。

## 使用

### 配置项

您可通过修改配置项 [connection_pool_mode](https://www.oceanbase.com/docs/common-odp-doc-cn-1000000003575555) 控制会话连接池的启用，例如，执行如下命令启用连接池：

```sql
obclient> alter proxyconfig set connection_pool_mode='session';

```

ODP 中同时提供了如下几个配置项用于控制会话连接池的使用，建议保持默认值：

| 配置项 | 默认值 | 含义 |
| --- | --- | --- |
| [session_pool_idle_timeout](https://www.oceanbase.com/docs/common-odp-doc-cn-1000000003575496) | 5m | 用于设置会话空闲超时时间，即会话被放回连接池后可以保留的最大时长。 |
| [session_pool_reset_interval](https://www.oceanbase.com/docs/common-odp-doc-cn-1000000003575369) | 10m | 于设置向连接池中未重置的会话发送 `COM_RESET_CONNECTION` 的时间间隔。 |
| [session_pool_stat_log_interval](https://www.oceanbase.com/docs/common-odp-doc-cn-1000000003575434) | 1m | 用于设置会话连接池统计日志时间间隔。 |

### 运维命令

- 查看会话信息

  您可使用 `root` 用户登录集群的 `sys` 租户，执行 `SHOW GLOBALSESSION` 命令查看会话连接池中的会话信息，此处以查看指定租户的会话信息为例，具体命令介绍可参见 [SHOW GLOBALSESSION](https://www.oceanbase.com/docs/common-odp-doc-cn-1000000003575640)。

  使用 `root` 用户登录集群的 `sys` 租户：

  ```shell
  [admin@obtest ~]$ obclient -uroot@sys#obcluster -h10.10.10.1 -P2883 -p

  ```

  查看会话信息：

  ```sql
  SHOW GLOBALSESSION ATTRIBUTE 'obcluster:test'\G

  ```

  输出如下：

  ```shell
  *************************** 1. row ***************************
         dbkey_name: obcluster:test
          auth_user: admin@test#obcluster
          server_ip: 10.10.10.1:25706
           local_ip: 10.10.10.2:35950
      session_state: KEEP_ALIVE_GLOBAL_SHARED
  server_session_id: 3222004961
              ss_id: 193
        create_time: 2025-04-08 16:55:26.458191
  last_release_time: 2025-04-08 16:55:38.803114
       timeout_time: 2025-04-08 17:25:38.803114
  *************************** 2. row ***************************
         dbkey_name: obcluster:test
          auth_user: admin@test#obcluster
          server_ip: 10.10.10.1:25704
           local_ip: 10.10.10.2:33250
      session_state: KEEP_ALIVE_GLOBAL_SHARED
  server_session_id: 3221679414
              ss_id: 43
        create_time: 2025-04-08 16:41:00.410908
  last_release_time: 2025-04-08 16:55:38.803067
       timeout_time: 2025-04-08 17:25:38.803067

  ```
 - 终止会话

  您可使用 `root` 用户登录集群的 `sys` 租户，执行 `KILL GLOBALSESSION` 命令终止会话连接池中的会话，此处以终止指定会话为例，具体命令介绍可参见 [KILL GLOBALSESSION](https://www.oceanbase.com/docs/common-odp-doc-cn-1000000003575637)。

  ```

  终止会话：

  ```sql
   KILL GLOBALSESSION 'obcluster:test' 193;

  ```

  示例中的 `193` 为执行 `SHOW GLOBALSESSION` 命令查看会话时，输出中的 `ss_id`，您可根据实际查看到的值进行替换。

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