# 连接导入

> 从 Navicat、DBeaver 和 DataGrip 导入连接、分组和可识别的数据库类型。

Source: https://dbxio.com/cn/docs/connection-import

Language: zh-CN

Relative links resolve against https://dbxio.com/cn/docs/connection-import.



DBX 可以从其他数据库工具导入连接，在切换工具时无需手动重新创建大量连接。

## 支持的格式

| 来源       | 格式                         | 导入内容                      |
| -------- | -------------------------- | ------------------------- |
| Navicat  | `.ncx` 导出文件                | 主机、端口、用户名、数据库类型、连接名称      |
| DBeaver  | 连接配置文件                     | 主机、端口、用户名、数据库类型、连接名称      |
| DataGrip | `dataSources.xml` 等项目/全局配置 | JDBC URL、驱动、连接名称、分组和可读取凭据 |

导入的连接保留原始连接名称和类型。其他工具以加密格式存储的密码无法解密——导入后需要重新输入密码。

## 导入 Navicat 连接

### 从 Navicat 导出

在 Navicat 中，选择要迁移的连接。使用**文件 → 导出连接**并保存 `.ncx` 文件。

### 打开导入对话框

在 DBX 中，前往**设置 → 导入连接**，或右键点击侧边栏分组标题选择**导入连接**。

### 选择 NCX 文件

选择从 Navicat 导出的 `.ncx` 文件。

### 检查并完成

DBX 解析文件并列出所有找到的连接。检查列表，在需要处重新输入密码并保存。

## 导入 DBeaver 连接

### 找到 DBeaver 配置

DBeaver 将连接存储在其工作区目录中。具体路径取决于操作系统和 DBeaver 版本。常见位置包括 `~/.local/share/DBeaverData/workspace6/General/.dbeaver/`。

### 打开导入对话框

在 DBX 中，前往**设置 → 导入连接**。

### 选择 DBeaver 文件

选择 DBeaver 连接配置文件（`.dbeaver-data-sources.xml` 或类似文件）。

### 检查并完成

DBX 从配置中提取连接信息。重新输入无法解密的密码。

## 导入 DataGrip 连接

### 选择配置

在 DBX 中选择**导入 DataGrip**，再选择 DataGrip 项目或全局配置中的 `dataSources.xml`；同目录的 local 配置会用于补充字段。

### 检查类型识别

DBX 会结合 driver reference、数据库产品名、JDBC subprotocol 和驱动类识别数据库。KingbaseES 等数据库会映射到对应 DBX profile，未知驱动保留为通用 JDBC。

### 检查分组

DataGrip 的分组路径会导入为 DBX 连接分组，方便保留项目组织方式。

### 补充凭据

macOS 上 DBX 会在允许时读取 DataGrip 钥匙串密码；其它加密或不可访问的凭据仍需手动填写。

## 导入后

导入的连接与手动创建的连接一同出现在侧边栏中。你应该：

* **测试每个连接**以验证导入的设置是否正常工作
* **设置密码**，用于原始密码无法导入的连接
* **分配连接颜色**以区分生产、测试和开发环境
* **配置 SSH 隧道**，用于需要隧道访问的连接
* **设置可见数据库过滤**，如果服务器包含大量数据库

## 无法导入的内容

| 设置       | 原因                       |
| -------- | ------------------------ |
| 加密密码     | 每个工具使用各自的加密方式，密码需要重新输入   |
| SSH 隧道密钥 | 密钥文件路径可能因机器而异，需要重新选择密钥文件 |
| 自定义驱动配置  | 驱动路径和版本是工具特定的            |
| 代理设置     | 在连接的代理标签页中重新配置           |

导入只创建连接草稿，不证明连接一定可用。保存前检查数据库 profile、JDBC URL、SSL、SSH、代理和数据库名，保存后逐个执行连接测试。

