89 lines
3.3 KiB
Plaintext
89 lines
3.3 KiB
Plaintext
---
|
||
title: 驱动管理
|
||
description: 管理内置和 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、YashanDB、GoldenDB、Kylin、SunDB 等 |
|
||
|
||
<Callout type="info">
|
||
原生驱动安装后立即可用。Agent 驱动需要一次性下载 JDBC 驱动和 JRE 设置，首次创建连接时 DBX 会自动处理。
|
||
</Callout>
|
||
|
||
## 驱动商店
|
||
|
||
驱动商店标签页显示所有可用的 Agent 驱动及其状态：
|
||
|
||
- **已安装驱动**：版本号、大小和更新可用性
|
||
- **可用驱动**：可一键安装的驱动
|
||
- **更新角标**：注册中心有新版本时显示
|
||
|
||
从**设置 → 驱动**打开驱动商店，或点击创建需要 Agent 驱动的连接时出现的驱动提示。
|
||
|
||
## 安装驱动
|
||
|
||
<Steps>
|
||
<Step>
|
||
### 打开驱动商店
|
||
导航到**设置 → 驱动**或点击连接对话框中的驱动安装提示。
|
||
</Step>
|
||
<Step>
|
||
### 选择驱动
|
||
找到所需的数据库驱动。每个条目显示支持的数据库和驱动版本。
|
||
</Step>
|
||
<Step>
|
||
### 点击安装
|
||
DBX 会下载 JDBC 驱动 JAR 及所需的依赖项。下载过程中显示进度。
|
||
</Step>
|
||
<Step>
|
||
### 创建连接
|
||
返回连接对话框。驱动此时即可使用。
|
||
</Step>
|
||
</Steps>
|
||
|
||
## 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 插件](/cn/docs/plugins)支持的数据库，当有新插件版本可用时，DBX 会显示更新通知。插件更新遵循与内置 Agent 驱动相同的安装流程。
|
||
|
||
## 故障排除
|
||
|
||
| 问题 | 解决方案 |
|
||
|---|---|
|
||
| 驱动下载失败 | 检查网络连接和防火墙规则。尝试离线导入方法。 |
|
||
| Agent 无法启动 | 在驱动商店中验证 JRE 安装。如需要，重新安装托管 JRE。 |
|
||
| 驱动安装后连接测试失败 | 确认 JDBC URL 格式与驱动的预期格式匹配。检查 SSH/代理设置。 |
|
||
| 驱动版本错误 | 卸载当前驱动并从商店安装正确版本。 |
|