本文介绍如何通过 GaiaDB 管理控制台配置连接池功能。

背景信息

连接池用于复用数据库连接，减少频繁创建和释放连接带来的系统开销，从而降低数据库负载并提升短连接场景下的访问性能。GaiaDB 当前支持 会话级连接池 和 事务级连接池 两种模式。

会话级连接池

会话级连接池适用于客户端连接数量较少的场景，例如在 Proxy 之前已经存在应用侧连接池的情况下，用于减少在连接池频繁获取与归还带来的额外开销。

开启会话级连接池后：

• 每个客户端连接会绑定固定的后端数据库连接，包括一个主库连接和一个从库连接（支持读写分离）；
• 同一客户端连接生命周期内执行的所有 SQL 请求，均复用已绑定的后端数据库连接；
• 当客户端连接断开时，系统会将对应的后端数据库连接回收到连接池中，以便后续连接复用。

通过维持会话级的连接绑定关系，可减少连接创建与释放次数，降低数据库建连开销，从而提升整体访问效率与连接稳定性。

事务级连接池

事务级连接池用于减少业务直接连接数据库的连接数量，并降低短连接场景下频繁建连带来的系统负载。

开启事务级连接池后：

• 客户端首先与代理建立连接；
• 代理不会立即与后端数据库建立连接，而是优先从事务级连接池中获取可用连接；
• 当前事务执行完成后，连接将被回收到连接池中，供后续请求复用。

该模式能够显著提升连接利用率，适用于高并发、短事务访问场景。

执行以下操作时，该客户端连接会绑定数据库连接直到客户端连接结束：

• 存储过程调用
• 锁定表LOCK TABLE
• load data local
• select ... into @var
• load data local
• 创建临时表
• 多语句

注意事项

• 版本支持情况

  • 标准版：支持配置连接池
  • 免费版：不支持自建代理，仅支持默认读写入口的连接池设置
  • 分布式版：暂不支持连接池功能
• 当前低版本集群暂不支持连接池配置，您可通过提交工单或联系对应 TAM 申请升级集群小版本，以使用该功能。
• 数据库代理的连接池功能并不影响客户端的连接池功能，若客户端已经支持连接池，则可以不使用数据库代理的连接池功能。
• 创建代理实例时，系统默认启用 事务级连接池，不支持关闭连接池。
• 修改连接池配置仅对新建立的连接生效。
• 如需使修改生效，需要重启应用程序或重新建立数据库连接。

设置连接池

1. 登录 GaiaDB管理控制台。
2. 在控制台页面左上角，选择实例所在地域。
3. 找到目标 GaiaDB 集群，点击 集群名称，进入GaiaDB 集群详情页。
4. 在基本信息页，选择目标的集群地址（代理实例），点击 修改配置。
5. 在 连接池设置 选择 会话级连接池或事务级连接池。
6. 确认配置后，点击 确定 即可完成连接池设置。