DBeaver中@include指令执行问题的分析与解决方案

问题概述

在DBeaver数据库管理工具的最新版本(24.3.2及24.3.4)中，用户报告了一个关于SQL脚本执行的重要功能问题。当使用@include指令引入外部SQL脚本文件时，系统并未按预期执行脚本内容，而是将脚本内容在单独的编辑器窗口中打开。

问题表现

该问题在不同数据库连接中表现不一致：

• 在PostgreSQL和Oracle连接中可稳定复现
• 在SQLite和ClickHouse连接中则无法复现

错误日志中会显示以下信息：

Datasource user 'org.jkiss.dbeaver.ui.editors.sql.SQLEditor@e809a1b' is not registered in datasource 'PostgreSQL 10 - ssh password'

技术背景

@include是DBeaver提供的一个实用指令，用于在当前SQL脚本中引入并执行外部SQL文件内容。这个功能对于模块化SQL开发特别有用，允许开发者将常用SQL语句存储在单独文件中，然后在多个脚本中复用。

问题原因分析

根据错误信息和不同数据库的表现差异，可以推断问题可能与以下因素有关：

1. 连接管理机制：错误信息表明系统在尝试使用编辑器对象而非有效用户凭证来访问数据源
2. 多连接处理：某些数据库驱动可能对多连接处理有特殊要求
3. 权限验证：SSH密码连接方式可能在此场景下存在验证流程问题

解决方案

目前确认有效的临时解决方案是：

1. 打开DBeaver的设置界面
2. 导航至"SQL编辑器"部分
3. 找到"打开独立连接"设置项
4. 将其值改为"从不"

这个设置调整可以绕过当前版本中的连接管理问题，使@include指令恢复正常功能。

注意事项

1. 该问题已被标记为重大缺陷(xp:major)和回归问题(regression)，意味着在之前版本中功能正常，新版本引入了此问题
2. 开发团队已确认问题存在，预计会在后续版本中发布修复
3. 使用临时解决方案时，需注意其对其他SQL执行功能可能产生的影响

最佳实践建议

1. 对于关键业务脚本，建议暂时避免使用@include指令，改为直接复制内容
2. 定期检查DBeaver的更新，以获取官方修复版本
3. 在团队开发环境中统一SQL脚本管理方式，减少对此功能的依赖

总结

DBeaver作为一款功能强大的数据库管理工具，偶尔会出现此类功能性问题。理解问题本质并掌握临时解决方案，可以帮助用户在不影响工作流程的情况下继续使用工具。同时，关注官方更新以获取永久修复是推荐的做法。