DBXDBX

驱动管理

管理内置和 Agent 驱动的 JDBC 驱动,配置 JRE 版本,处理驱动更新。

DBX 使用混合驱动架构:常用数据库使用内置原生驱动,需要供应商特定 JDBC 驱动的数据库使用 JDBC Agent 系统。

驱动架构

驱动类型工作方式适用场景
原生(内置)Rust 驱动编译进 DBXMySQL、PostgreSQL、SQLite、SQL Server、Oracle、Redis、MongoDB、DuckDB、ClickHouse 等
JDBC AgentDBX 管理的 Java 子进程提供 JDBC 驱动的数据库:GaussDB、openGauss、DM、KingBase、HighGo、Vastbase、Trino、Hive、DB2、Informix、Neo4j、TDengine、虚谷 XuguDB、YashanDB、GoldenDB、Kylin、SunDB 等

原生驱动安装后立即可用。Agent 驱动需要一次性下载 JDBC 驱动和 JRE 设置,首次创建连接时 DBX 会自动处理。

驱动商店

驱动商店标签页显示所有可用的 Agent 驱动及其状态:

  • 已安装驱动:版本号、大小和更新可用性
  • 可用驱动:可一键安装的驱动
  • 更新角标:注册中心有新版本时显示

设置 → 驱动打开驱动商店,或点击创建需要 Agent 驱动的连接时出现的驱动提示。

安装驱动

打开驱动商店

导航到设置 → 驱动或点击连接对话框中的驱动安装提示。

选择驱动

找到所需的数据库驱动。每个条目显示支持的数据库和驱动版本。

点击安装

DBX 会下载 JDBC 驱动 JAR 及所需的依赖项。下载过程中显示进度。

创建连接

返回连接对话框。驱动此时即可使用。

JRE 管理

JDBC Agent 驱动需要 Java 运行环境。DBX 内置 JRE 管理:

  • 系统 JRE:DBX 可使用系统上已有的 Java 安装
  • 托管 JRE:DBX 可下载并管理自己的 JRE,与系统 Java 隔离
  • 多 JRE 支持:不同驱动可按需使用不同 JRE 版本
  • 重新安装:如托管 JRE 损坏,可从驱动商店重新安装

驱动更新

DBX 会定期检查驱动更新:

  • 有新版本时,驱动商店标签页上会显示更新角标
  • 点击升级全部驱动一次性更新所有已安装的驱动
  • 单个驱动可从商店中对应条目升级

离线驱动导入

对于无法访问互联网的环境,DBX 支持离线驱动安装:

  1. 从另一台机器下载 JDBC 驱动 ZIP 包
  2. 将其传输到离线机器
  3. 在驱动商店中使用从 ZIP 导入安装驱动包

这适用于气隙网络、严格防火墙环境或企业中预先批准的驱动版本。

插件更新

对于由 JDBC 插件支持的数据库,当有新插件版本可用时,DBX 会显示更新通知。插件更新遵循与内置 Agent 驱动相同的安装流程。

故障排除

问题解决方案
驱动下载失败检查网络连接和防火墙规则。尝试离线导入方法。
Agent 无法启动在驱动商店中验证 JRE 安装。如需要,重新安装托管 JRE。
驱动安装后连接测试失败确认 JDBC URL 格式与驱动的预期格式匹配。检查 SSH/代理设置。
驱动版本错误卸载当前驱动并从商店安装正确版本。

本页目录