数据库连接
「数据库连接」是安捷智用 AI 应用平台的数据底座中心配置模块，用于将企业外部数据源接入平台。您可以在这里新建、测试、编辑和删除各类数据库连接，为数据表、报表、智能问数等业务场景提供统一的数据来源。
一、功能总览介绍
「数据库连接」承担"把企业数据源接入平台"的职责，支持18 种主流的数据库 / 数据源类型，覆盖关系型、国产、文件型、NoSQL、时序、分析型及接口型数据源。
数据库连接是数据底座的核心入口，新建连接后即可在 SQL 数据表等场景中引用该数据源。
1.1 模块能做什么
| 能力 | 说明 |
|---|---|
| 多源异构接入 | 支持 18 +种主流数据库 / 数据源类型，覆盖关系型、国产、文件型、NoSQL、时序、分析型及接口型 |
| 统一登记管理 | 所有连接集中登记，通过"连接列表"统一查看、筛选、编辑、删除 |
| 连接可用性校验 | 提供独立的「连接测试」能力，保存前即可验证连接参数是否正确 |
| 数据库自动发现 | 部分类型支持「获取列表」，输入地址 / 账号后自动拉取可用的数据库名称，免去手工录入 |
| 业务系统识别 | 通过「软件标识」可标注金蝶 / 用友等 ERP 软件版本，便于平台识别业务表结构（数据字典） |
1.2 进入路径
- 使用账号登录平台；
- 在「请选择你进入的企业」中选择目标组织；
- 在左侧主导航点击 「系统管理」；
- 点击 「数据库连接」。
二、新建数据库连接
2.1 通用操作步骤
无论创建哪种类型的连接，整体流程一致：
- 点击 「新建连接」，打开「新建数据库连接」对话框；
- 填写 「连接名称」（必填，自定义，建议含业务含义，如"财务数据仓库"）；
- 在「数据库类型」中选择目标类型——选定后，下方表单字段会按类型自动变化；
- 按该类型要求填写连接参数（带
*为必填）； - 点击 「连接测试」 校验连通性；
- 测试通过后点击 「确 定」 保存。
提示：除下表特有字段外，所有类型均含「连接名称（必填）」「数据库类型（必填）」两项基础字段；绝大多数类型还含「软件标识」「备注」两个选填项。
2.2 SQL Server 数据库
适用于 Microsoft SQL Server，也是对接用友 U8、金蝶等 ERP 后台库的常见类型。
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义，如"ERP数据库" |
| 数据库地址 | ✅ | 服务器 IP 或主机名，如 127.0.0.1 |
| 数据库端口 | ✅ | 默认 1433 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 目标库名，如 UFDATA_001_2017，可点击"获取列表"自动拉取 |
| 软件标识 | ◻ | 若该库来自金蝶 / 用友等 ERP，可选择对应软件版本 |
| 字符集 | ◻ | 按需选择 |
| TDS 版本 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
操作要点：填写完地址、端口、账号、密码后，先点「获取列表」自动拉取数据库名称，再「连接测试」→「确定」。
2.3 MySQL 数据库
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 数据库端口 | ✅ | 默认 3306 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 目标库名，可点击"获取列表"自动拉取 |
| 软件标识 | ◻ | 按需选择 |
| 字符集 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.4 Oracle 数据库
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 数据库端口 | ✅ | 默认 1521 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 服务名 / SID |
| 软件标识 | ◻ | 按需选择 |
| 字符集 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.5 SQLite 数据库
SQLite 为本地文件型数据库，无需端口、用户名、密码、数据库名称，只需填写文件地址。
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义，如"演示数据" |
| 数据库地址 | ✅ | SQLite 文件路径或文件名，如 D:\AgileWork\dcp\零售AI演示数据.db |
| 软件标识 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
补充说明：如果把sqlite文件，放在产品安装路径的dcp文件夹下，如：D:\AgileWork\dcp，则数据库地址可以直接填文件名，如：零售AI演示数据.db
2.6 MariaDB 数据库
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 数据库端口 | ✅ | 默认 3306 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 目标库名，可点击"获取列表"自动拉取 |
| 软件标识 | ◻ | 按需选择 |
| 字符集 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.7 DB2 数据库
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 数据库端口 | ✅ | 服务端口 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 目标库名 |
| 软件标识 | ◻ | 按需选择 |
| 字符集 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.8 SAP HANA 数据库
内存分析型数据库。
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 数据库端口 | ✅ | 默认 39015 或按实例 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 目标库名 |
| 软件标识 | ◻ | 按需选择 |
| 字符集 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.9 PostgreSQL 数据库
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 数据库端口 | ✅ | 默认 5432 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 目标库名，可点击"获取列表"自动拉取 |
| 软件标识 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注（无字符集项） |
2.10 DB2/AS400 数据库
字段与 DB2 完全一致：连接名称、数据库地址、数据库端口、用户名、密码、数据库名称、软件标识、字符集、备注。按实际数据库选型即可。
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 数据库端口 | ✅ | 服务端口 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 目标库名 |
| 软件标识 | ◻ | 按需选择 |
| 字符集 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.11 瀚高数据库
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 数据库端口 | ✅ | 服务端口 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 目标库名，可点击"获取列表"自动拉取 |
| 软件标识 | ◻ | 按需选择 |
| 字符集 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.12 人大金仓数据库
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 数据库端口 | ✅ | 服务端口 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 目标库名，可点击"获取列表"自动拉取 |
| 软件标识 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.13 达梦数据库
📌 注意：达梦类型无需单独填写"数据库名称"（达梦以实例 / 模式区分，地址 + 账号即可连接）。
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 数据库端口 | ✅ | 服务端口 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 软件标识 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.14 MongoDB 数据库
特有字段：除常规地址、端口、账号、密码、数据库名称外，多一个 「验证数据库」（auth_source） 选填项——用于指定账号鉴权时所用的库（默认为
admin，若账号建在业务库则需填对应库名）。
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 数据库端口 | ✅ | 默认 27017 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 验证数据库 | ◻ | 鉴权所用库（auth_source） |
| 数据库名称 | ✅ | 目标库名 |
| 软件标识 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.15 InfluxDB 数据库
时序数据库。
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 数据库端口 | ✅ | 默认 8086 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 目标库名 |
| 软件标识 | ◻ | 按需选择 |
| 字符集 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.16 ElasticSearch 数据库
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 数据库端口 | ✅ | 默认 9200 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 目标库名 |
| 软件标识 | ◻ | 按需选择 |
| 字符集 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.17 SSAS 连接
SQL Server Analysis Services 多维 / 表格模型，无端口字段。
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库地址 | ✅ | 服务器 IP 或主机名 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 目标库名 |
| 软件标识 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.18 ODBC 连接
通过 ODBC 通用驱动接入未直接列举的数据库，扩展性最强。
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| ODBC 驱动 | ✅ | 选择已安装的 ODBC 驱动程序 |
| 自定义连接 | ◻ | 自定义连接串 / 连接参数 |
| 数据库地址 | ✅ | 服务器地址 |
| 数据库端口 | ✅ | 端口 |
| 用户名 | ✅ | 登录账号 |
| 密码 | ✅ | 登录密码 |
| 数据库名称 | ✅ | 目标库名 |
| 软件标识 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
2.19 XZAPI 连接
用于对接小智平台产生的 API 形态数据源，字段结构与其他类型差异最大，无端口、无传统库名。
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| API 访问地址 | ✅ | 接口的服务地址 |
| 接口 KEY | ✅ | 接口鉴权 KEY |
| 接口 Secret | ✅ | 接口鉴权 Secret |
| 软件标识 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
三、数据库连接管理
进入「数据库连接」后，页面由 左侧连接树 与 右侧列表区 两部分组成。点击任一连接，右侧会展示该连接的详情面板。
3.1 数据库连接列表
页面整体结构
| 区域 | 说明 |
|---|---|
| 连接列表树 | 顶部有「连接列表」标题与「新建连接」按钮；下方「所有数据库连接」分组按连接名称列出全部已建连接，点击任一连接可快速定位并查看详情 |
| 筛选区 | 提供「数据库类型」下拉筛选与「连接名称」搜索框，可按类型、名称快速过滤 |
| 数据表格 | 以表格形式展示所有连接的核心信息与操作入口 |
| 分页区 | 底部显示数据总量（如"共 23条"）、每页条数切换（默认 20 条/页）、页码跳转 |
数据表格字段说明
| 列名 | 说明 | 示例 |
|---|---|---|
| 连接名称 | 该连接的显示名称，用于在平台其他模块中识别和引用 | 财务数据仓库 |
| 数据库类型 | 该连接对应的数据库 / 数据源类型 | SQL Server、SQLite |
| 数据库地址 | 数据库服务器的访问地址（IP 或域名）；文件型数据库显示文件名 | 127.0.0.1、产供销底数据.sqlite |
| 数据库名称 | 所连接的具体库名 | TIZ_FastBI_FI、UFDATA_001_2017 |
| 最后编辑用户 | 最近一次修改该连接的操作人 | 产品部、admin |
| 最后编辑时间 | 最近一次修改的时间 | 2026-10-14 12:17:24 |
| 操作 | 行级操作按钮：编辑、删除 | — |
筛选与检索
-
按数据库类型筛选：点击「数据库类型」下拉框，选择某一类型（如 MySQL），列表仅显示该类型的连接。
-
按连接名称搜索：在「连接名称」搜索框中输入关键词，列表实时过滤匹配的连接。
3.2 列表详情-基本信息
点击左侧连接树或列表中任一连接名称后，详情面板默认展示「基本信息」页签，内容包括配置信息与创建信息两部分。
| 分类 | 字段 | 说明 |
|---|---|---|
| 配置信息 | 连接名称 | 该连接的显示名称 |
| 数据库类型 | 该连接对应的数据库 / 数据源类型 | |
| 数据库地址 | 服务器地址或文件路径 | |
| 用户名 | 登录账号（密码不在此展示） | |
| 数据库名称 | 目标库名（视类型而定） | |
| 字符集 | 字符编码 | |
| 备注 | 连接备注说明 | |
| 创建信息 | 创建用户 | 首次创建该连接的操作人 |
| 创建时间 | 创建时间 | |
| 最后编辑时间 | 最近一次修改的时间 |
3.3 列表详情-引用记录
「引用记录」页签用于展示引用了该连接的数据表列表，帮助您了解该连接正被哪些业务场景使用，避免误删。
| 列名 | 说明 |
|---|---|
| 数据表名称 | 引用该连接的 SQL 数据表名称 |
| 更新策略 | 数据表的更新方式（如"抽取"） |
| 创建用户 | 数据表的创建人 |
| 创建时间 | 数据表的创建时间 |
| 最后编辑时间 | 数据表最近修改时间 |
若某连接已被数据模型、报表、智能问数等场景引用，删除前请先在「引用记录」中确认引用关系，以免影响已配置的业务场景。
四、数据库连接操作
4.1 连接测试
「连接测试」按钮位于新建 / 编辑对话框底部以及连接详情面板顶部，用于依据当前填写的参数（地址、端口、账号、密码、库名等）即时发起一次连通性测试，校验连接是否可用。
-
测试通过后再保存，可避免保存无效连接；
-
测试失败时，请按第 5 章常见问题逐项排查。
4.2 编辑
「编辑」按钮位于连接列表的操作列以及详情面板顶部。点击后打开「编辑数据库连接」对话框，可修改连接名称、地址、账号、密码等参数；保存后将更新「最后编辑用户 / 时间」。
4.3 删除
「删除」按钮位于连接列表的操作列以及详情面板顶部。点击后系统会进行二次确认，确认后删除该连接记录。
⚠️ 提示：若某连接已被数据模型、报表、智能问数等场景引用，删除前请先确认引用关系，以免影响已配置的业务场景。
五、数据库连接常见问题
| 问题 | 解决建议 |
|---|---|
| 连接测试失败 | ① 核对地址、端口是否正确；② 确认账号密码无误且具备库访问权限；③ 确认数据库对平台服务器网络可达（防火墙 / 白名单）；④ 字符集是否匹配 |
| 「获取列表」拉不到库名 | 先确认地址 + 账号 + 密码已正确填写并能通过连接测试，再重新点击获取 |
| SQLite 连接不上 | 核对文件路径 / 文件名是否正确，文件是否已上传至平台可访问的位置 |
| 删除连接时提示已被引用 | 先到「引用记录」/ 数据模型 / 报表 / 智能问数中解除对该连接的引用，再执行删除 |
| 达梦连不上 | 达梦无需填库名；地址 + 账号即可连接 |
| 国产库 / 人大金仓 / 瀚高连不上 | 参照 PostgreSQL 字段核对端口与模式 |