Files
dbx/docs/content/docs/connection-import.cn.mdx
T

125 lines
4.0 KiB
Plaintext

---
title: 连接导入
description: 从 Navicat、DBeaver 和 DataGrip 导入连接、分组和可识别的数据库类型。
---
DBX 可以从其他数据库工具导入连接,在切换工具时无需手动重新创建大量连接。
## 支持的格式
| 来源 | 格式 | 导入内容 |
| ------- | --------------- | ---------------------------------------- |
| Navicat | `.ncx` 导出文件 | 主机、端口、用户名、数据库类型、连接名称 |
| DBeaver | 连接配置文件 | 主机、端口、用户名、数据库类型、连接名称 |
| DataGrip | `dataSources.xml` 等项目/全局配置 | JDBC URL、驱动、连接名称、分组和可读取凭据 |
<Callout type="info">导入的连接保留原始连接名称和类型。其他工具以加密格式存储的密码无法解密——导入后需要重新输入密码。</Callout>
## 导入 Navicat 连接
<Steps>
<Step>
### 从 Navicat 导出
在 Navicat 中,选择要迁移的连接。使用**文件 → 导出连接**并保存 `.ncx` 文件。
</Step>
<Step>
### 打开导入对话框
在 DBX 中,前往**设置 → 导入连接**,或右键点击侧边栏分组标题选择**导入连接**。
</Step>
<Step>
### 选择 NCX 文件
选择从 Navicat 导出的 `.ncx` 文件。
</Step>
<Step>
### 检查并完成
DBX 解析文件并列出所有找到的连接。检查列表,在需要处重新输入密码并保存。
</Step>
</Steps>
## 导入 DBeaver 连接
<Steps>
<Step>
### 找到 DBeaver 配置
DBeaver 将连接存储在其工作区目录中。具体路径取决于操作系统和 DBeaver 版本。常见位置包括 `~/.local/share/DBeaverData/workspace6/General/.dbeaver/`。
</Step>
<Step>
### 打开导入对话框
在 DBX 中,前往**设置 → 导入连接**。
</Step>
<Step>
### 选择 DBeaver 文件
选择 DBeaver 连接配置文件(`.dbeaver-data-sources.xml` 或类似文件)。
</Step>
<Step>
### 检查并完成
DBX 从配置中提取连接信息。重新输入无法解密的密码。
</Step>
</Steps>
## 导入 DataGrip 连接
<Steps>
<Step>
### 选择配置
在 DBX 中选择**导入 DataGrip**,再选择 DataGrip 项目或全局配置中的 `dataSources.xml`;同目录的 local 配置会用于补充字段。
</Step>
<Step>
### 检查类型识别
DBX 会结合 driver reference、数据库产品名、JDBC subprotocol 和驱动类识别数据库。KingbaseES 等数据库会映射到对应 DBX profile,未知驱动保留为通用 JDBC。
</Step>
<Step>
### 检查分组
DataGrip 的分组路径会导入为 DBX 连接分组,方便保留项目组织方式。
</Step>
<Step>
### 补充凭据
macOS 上 DBX 会在允许时读取 DataGrip 钥匙串密码;其它加密或不可访问的凭据仍需手动填写。
</Step>
</Steps>
## 导入后
导入的连接与手动创建的连接一同出现在侧边栏中。你应该:
- **测试每个连接**以验证导入的设置是否正常工作
- **设置密码**,用于原始密码无法导入的连接
- **分配连接颜色**以区分生产、测试和开发环境
- **配置 SSH 隧道**,用于需要隧道访问的连接
- **设置可见数据库过滤**,如果服务器包含大量数据库
## 无法导入的内容
| 设置 | 原因 |
| -------------- | ------------------------------------------------ |
| 加密密码 | 每个工具使用各自的加密方式,密码需要重新输入 |
| SSH 隧道密钥 | 密钥文件路径可能因机器而异,需要重新选择密钥文件 |
| 自定义驱动配置 | 驱动路径和版本是工具特定的 |
| 代理设置 | 在连接的代理标签页中重新配置 |
导入只创建连接草稿,不证明连接一定可用。保存前检查数据库 profile、JDBC URL、SSL、SSH、代理和数据库名,保存后逐个执行连接测试。