驱动管理
管理内置和 Agent 驱动的 JDBC 驱动,配置 JRE 版本,处理驱动更新。
DBX 使用混合驱动架构:常用数据库使用内置原生驱动,需要供应商特定 JDBC 驱动的数据库使用 JDBC Agent 系统。
驱动架构
| 驱动类型 | 工作方式 | 适用场景 |
|---|---|---|
| 原生(内置) | Rust 驱动编译进 DBX | MySQL、PostgreSQL、SQLite、SQL Server、Oracle、Redis、MongoDB、DuckDB、ClickHouse 等 |
| JDBC Agent | DBX 管理的 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 支持离线驱动安装:
- 从另一台机器下载 JDBC 驱动 ZIP 包
- 将其传输到离线机器
- 在驱动商店中使用从 ZIP 导入安装驱动包
这适用于气隙网络、严格防火墙环境或企业中预先批准的驱动版本。
插件更新
对于由 JDBC 插件支持的数据库,当有新插件版本可用时,DBX 会显示更新通知。插件更新遵循与内置 Agent 驱动相同的安装流程。
故障排除
| 问题 | 解决方案 |
|---|---|
| 驱动下载失败 | 检查网络连接和防火墙规则。尝试离线导入方法。 |
| Agent 无法启动 | 在驱动商店中验证 JRE 安装。如需要,重新安装托管 JRE。 |
| 驱动安装后连接测试失败 | 确认 JDBC URL 格式与驱动的预期格式匹配。检查 SSH/代理设置。 |
| 驱动版本错误 | 卸载当前驱动并从商店安装正确版本。 |