DBeaver 24.3.4版本中Azure Databricks数据库导航器架构显示异常问题解析

问题背景

近期有用户反馈，在升级DBeaver至24.3.4版本后，连接Azure Databricks时数据库导航器的显示逻辑发生显著变化。具体表现为：

1. 旧版（24.2.4）正常显示三级结构：Catalog → Schema → 表/视图等对象
2. 新版将所有对象扁平化展示，Schema层级消失，导致对象管理混乱

技术分析

根据用户提供的日志片段，系统在元数据加载过程中存在大量与Schema相关的错误。结合Databricks的Unity Catalog特性，推测可能涉及以下技术点：

1. JDBC驱动兼容性
   有用户反馈通过强制更新Databricks JDBC驱动可解决问题，表明新版本可能存在驱动适配问题。Databricks近期更新了元数据API，可能导致旧版驱动无法正确解析Schema层级。

2. 元数据缓存机制
   DBeaver的版本升级可能修改了元数据缓存策略，24.3.4版本可能错误地将Schema识别为普通文件夹而非层级结构。

3. 配置继承问题
   用户回退到24.2.4版本后出现对象属性无法展开的新问题，说明版本升级过程可能修改了核心配置文件（如dbeaver-data-sources.xml或元数据缓存数据库）。

解决方案

临时解决方案

1. 驱动更新方案
   通过以下路径更新驱动：

   • 打开"数据库驱动管理器"
   • 定位Databricks驱动
   • 右键选择"下载/更新"
   • 重启DBeaver

2. 配置重置方案
   对于已出现属性无法展开的情况：

   • 关闭DBeaver
   • 删除工作空间目录下的/.metadata/.plugins/org.jkiss.dbeaver.core文件夹
   • 重新启动时会重建元数据缓存

长期建议

1. 版本隔离部署
   建议将不同版本的DBeaver解压到独立目录运行，避免配置冲突。Windows用户可使用便携版（zip）实现多版本共存。

2. 元数据预加载
   在连接属性中启用"连接时加载元数据"选项，强制刷新元数据缓存。

技术原理补充

Databricks Unity Catalog采用三级命名空间（Catalog-Schema-Table），与传统数据库的Schema概念存在差异。DBeaver 24.3.4可能错误应用了扁平化处理逻辑，这种情况在元数据API响应超时或格式异常时尤为常见。建议用户关注Databricks官方JDBC驱动的更新日志，特别是与DatabaseMetaData.getSchemas()方法相关的改动说明。

后续版本跟踪

该问题已被标记为已关闭，表明开发团队可能已在后续版本中修复。建议用户关注24.3.5及以上版本的发布说明，或通过"帮助→检查更新"功能获取热修复补丁。