JDBC和ODBC开发规范

应用场景

连接池机制的核心优势在于连接复用，避免频繁建立和断开数据库连接带来的网络开销和认证成本。以下场景推荐使用连接池：

• 高并发场景：应用需要处理大量并发数据库请求，频繁创建连接会影响性能。
• 短连接场景：每个数据库操作时间短，连接建立/断开的开销相对较大。
• 微服务架构：多个服务实例共享连接池，提升资源利用率。

约束与限制

• 连接池中的连接在归还前必须清除会话状态，否则会导致后续操作使用残留配置（如下所示），产生非预期结果。
  • 权限残留：若会话中切换了用户身份未重置，后续操作将以错误的用户身份执行，存在安全风险。
  • 配置残留：GUC参数残留可能导致后续查询行为异常（如超时时间、隔离级别不正确）。
  • 对象冲突：残留的临时表可能与后续操作中的同名对象冲突，导致报错。
• 仅使用连接池机制时需遵循本规范，单次连接（每次新建连接并关闭）无需额外处理。

开发规范

在应用程序将连接归还连接池之前，请按以下规范处理会话状态：

1. 清除GUC参数和会话身份：如果在连接使用期间设置了GUC参数或切换了会话用户身份，在归还连接前，必须执行以下命令将会话状态清空。
   1. 重置会话用户身份为初始登录用户：

      SET SESSION AUTHORIZATION DEFAULT; 

   2. 将当前会话中所有被修改的GUC参数恢复为默认值：

      RESET ALL;

2. 删除临时表：如果在连接使用期间创建了临时表，在归还连接前，必须将所有临时表删除。可使用以下命令，其中“temp_table_name”为实际临时表名称：

   DROP TABLE IF EXISTS temp_table_name; 

   或直接结束会话（临时表会随会话自动清除），但在连接池场景下需显式删除，因为连接不会被真正关闭。
3. 验证会话状态已清除（可选）：归还连接前，可执行以下命令确认会话状态已重置：

   SHOW session_authorization;

   确认返回值为初始登录用户，即表示会话身份已成功重置。

相关文档

• 驱动下载：下载JDBC或ODBC驱动
• JDBC和ODBC开发：使用JDBC或ODBC进行DWS二次开发
• 常见问题：无法连接DWS集群时怎么处理？