DBeaver SQL脚本包含功能连接传递机制解析

问题背景

在数据库开发工具DBeaver中，用户经常需要通过@include指令实现SQL脚本的模块化组织。在24.3.3版本中，用户报告了一个关键功能变化：当主脚本通过@include调用子脚本时，子脚本无法继承主脚本的数据库连接，导致"No active connection"错误。

技术原理

DBeaver的脚本执行引擎采用连接上下文传递机制。理想情况下：

1. 主脚本建立数据库连接后，该连接对象应作为执行上下文的一部分
2. 通过@include调用的子脚本应自动继承这个连接上下文
3. 子脚本执行时无需重新建立连接

版本行为对比

• 旧版本(24.3.3之前)：

  • 连接上下文自动传递
  • 子脚本可直接使用主脚本连接
  • 实现跨脚本的事务统一管理

• 24.3.3问题版本：

  • 连接上下文传递中断
  • 每个@include脚本需要独立连接
  • 破坏脚本执行的原子性

影响范围

该问题主要影响：

1. 模块化设计的SQL脚本体系
2. 依赖脚本包含的自动化部署流程
3. 需要跨脚本事务控制的场景

解决方案验证

最新版本已修复该问题，验证方法：

1. 创建测试脚本：

   -- main.sql
   @include "sub.sql"
   
   -- sub.sql
   SELECT current_database();
   

2. 执行时应能正确返回当前数据库名称
3. 无连接错误提示

最佳实践建议

1. 版本升级：建议升级到最新稳定版
2. 脚本设计：
   • 明确注释包含关系
   • 避免循环包含
   • 关键操作添加连接验证
3. 事务管理：
   • 重要操作考虑显式事务控制
   • 包含脚本中避免自动提交

技术延伸

SQL脚本模块化的其他实现方式：

1. 存储过程封装
2. 使用脚本变量传递参数
3. DBeaver的脚本模板功能
4. 数据库特有的包含语法（如Oracle的@）

该问题的修复体现了DBeaver对脚本执行一致性的重视，确保了复杂SQL工程的可维护性。