【数据库连接】模块概述
适用产品：安捷智用 AI 应用平台
模块路径：系统管理 → 数据与门户 → 数据库连接
1. 模块介绍
1.1 模块定位
「数据库连接」是安捷智用 AI 应用平台数据底座中心的核心配置入口，承担"把企业外部数据源接入平台"的职责。
1.2 模块能做什么
| 能力 | 说明 |
|---|---|
| 多源异构接入 | 支持 18 种主流数据库 / 数据源类型，覆盖关系型、国产、文件型、NoSQL、时序、分析型及接口型数据源 |
| 统一登记管理 | 所有连接集中登记，按"连接列表"统一查看、筛选、编辑、删除 |
| 连接可用性校验 | 提供独立的「连接测试」能力，保存前即可验证连接参数是否正确 |
| 数据库自动发现 | 部分类型支持「获取列表」，输入地址 / 账号后自动拉取可用的数据库名称，免去手工录入 |
| 业务系统识别 | 通过「软件标识」可标注金蝶 / 用友等 ERP 软件版本，便于平台识别业务表结构（数据字典） |
1.3 进入路径
- 使用账号登录平台；
- 在「请选择你进入的企业」中选择目标组织（如「【企业门户】体验组织」）；
- 在左侧主导航点击 「系统管理」；
- 点击 「数据库连接」。
2. 模块列表功能
进入「数据库连接」后，页面由 左侧连接树 与 右侧列表区 两部分组成。
2.1 页面整体结构
| 区域 | 说明 |
|---|---|
| 左侧 · 连接列表树 | 顶部有「连接列表」标题与「新建连接」按钮；下方「所有数据库连接」分组按连接名称列出全部已建连接，点击任一连接可快速定位 |
| 右侧 · 筛选区 | 提供「数据库类型」下拉筛选与「连接名称」搜索框，可按类型、名称快速过滤 |
| 右侧 · 数据表格 | 以表格形式展示所有连接的核心信息与操作入口 |
| 右侧 · 分页区 | 底部显示数据总量（如"共 7 项数据"）、每页条数切换（默认 20 条/页）、页码跳转 |
📷 配图建议 2：数据库连接列表页全景截图，用框线分别标注：①左侧连接树 ②筛选区 ③数据表格 ④分页区。
2.2 数据表格字段说明
列表表格包含以下列：
| 列名 | 说明 | 示例 |
|---|---|---|
| 连接名称 | 该连接的显示名称，用于在平台其他模块中识别和引用 | 财务数据仓库 |
| 数据库类型 | 该连接对应的数据库 / 数据源类型 | SQL Server、SQLite |
| 数据库地址 | 数据库服务器的访问地址（IP 或域名）；文件型数据库显示文件名 | 127.0.0.1、众德_产供销底数据.sqlite |
| 数据库名称 | 所连接的具体库名 | TIZ_FastBI_FI、UFDATA_001_2017 |
| 最后编辑用户 | 最近一次修改该连接的操作人 | 天智Nicole、admin |
| 最后编辑时间 | 最近一次修改的时间 | 2026-06-17 19:43:42 |
| 操作 | 行级操作按钮：编辑、删除 | — |
📷 配图建议 3：列表表格单行特写，标注各列含义（可参考示例数据：财务数据仓库 / SQL Server / 127.0.0.1 / TIZ_FastBI_FI）。
2.3 筛选与检索
-
按数据库类型筛选：点击「数据库类型」下拉框，选择某一类型（如 MySQL），列表仅显示该类型的连接。
-
按连接名称搜索：在「连接名称」搜索框中输入关键词，列表实时过滤匹配的连接。
3. 列表的各个按钮功能
3.1 页面级按钮
| 按钮 | 位置 | 功能 |
|---|---|---|
| 新建连接 | 左侧连接树顶部 / 列表主操作区 | 打开「新建数据库连接」对话框，创建一条新的数据库连接（详见第 4 节） |
3.2 行级操作按钮（操作列）
每条连接记录的「操作」列提供以下按钮：
| 按钮 | 功能 |
|---|---|
| 编辑 | 打开该连接的编辑对话框，可修改连接名称、地址、账号、密码等参数；保存后将更新「最后编辑用户 / 时间」 |
| 删除 | 删除该连接记录。删除前系统会进行二次确认，避免误删正在被报表 / 模型引用的连接 |
⚠️ 提示：若某连接已被数据模型、报表、智能问数等场景引用，删除前请先确认引用关系，以免影响已配置的业务场景。
3.3 新建 / 编辑对话框内的按钮
在「新建 / 编辑数据库连接」对话框底部，提供三个操作按钮：
| 按钮 | 功能 |
|---|---|
| 连接测试 | 依据当前填写的参数（地址、端口、账号、密码、库名等）即时发起一次连通性测试，校验连接是否可用；测试通过后再保存，可避免保存无效连接 |
| 取 消 | 放弃当前填写内容，关闭对话框 |
| 确 定 | 校验必填项通过后，保存连接并关闭对话框 |
4. 相关文档：创建各类数据库连接
4.1 支持的数据库类型总览
平台「新建数据库连接」对话框支持以下 18 种 数据库 / 数据源类型：
| 分类 | 类型 |
|---|---|
| 关系型数据库 | SQL Server、MySQL、Oracle、MariaDB、PostgreSQL、DB2、DB2/AS400 |
| 国产数据库 | 人大金仓、达梦、瀚高 |
| 文件型数据库 | SQLite |
| 分析 / 多维型 | SSAS |
| NoSQL | MongoDB |
| 时序 / 检索型 | InfluxDB、ElasticSearch |
| 内存分析型 | SAP HANA |
| 接口 / 通用型 | XZAPI（平台 API 数据源）、ODBC |
4.2 通用操作步骤
无论创建哪种类型的连接，整体流程一致：
- 点击 「新建连接」，打开对话框；
- 填写 「连接名称」（必填，自定义，建议含业务含义，如"财务数据仓库"）；
- 在「数据库类型」中选择目标类型——选定后，下方表单字段会按类型自动变化；
- 按该类型要求填写连接参数（带
*为必填）； - 点击 「连接测试」 校验连通性；
- 测试通过后点击 「确 定」 保存。
📷 配图建议 4：新建数据库连接对话框全景截图，标注：①连接名称 ②数据库类型选择区（18 个类型按钮）③动态参数表单 ④连接测试 / 取消 / 确定 按钮。
4.3 各类型字段对照总表
下表汇总各类型在新建对话框中的字段差异（✅ 必填 · ◻ 选填 · — 不显示）。除下表特有字段外，所有类型均含「连接名称（必填）」「数据库类型（必填）」两项基础字段；绝大多数类型还含「软件标识」「备注」两个选填项。
| 数据库类型 | 数据库地址 | 数据库端口 | 用户名 | 密码 | 数据库名称 | 字符集 | 特有字段 |
|---|---|---|---|---|---|---|---|
| SQL Server | ✅ | ✅ | ✅ | ✅ | ✅ | ◻ | — |
| MySQL | ✅ | ✅ | ✅ | ✅ | ✅ | ◻ | — |
| MariaDB | ✅ | ✅ | ✅ | ✅ | ✅ | ◻ | — |
| Oracle | ✅ | ✅ | ✅ | ✅ | ✅ | ◻ | — |
| PostgreSQL | ✅ | ✅ | ✅ | ✅ | ✅ | — | — |
| 人大金仓 | ✅ | ✅ | ✅ | ✅ | ✅ | — | — |
| 瀚高 | ✅ | ✅ | ✅ | ✅ | ✅ | ◻ | — |
| DB2 | ✅ | ✅ | ✅ | ✅ | ✅ | ◻ | — |
| DB2/AS400 | ✅ | ✅ | ✅ | ✅ | ✅ | ◻ | — |
| InfluxDB | ✅ | ✅ | ✅ | ✅ | ✅ | ◻ | — |
| ElasticSearch | ✅ | ✅ | ✅ | ✅ | ✅ | ◻ | — |
| SAP HANA | ✅ | ✅ | ✅ | ✅ | ✅ | ◻ | — |
| 达梦 | ✅ | ✅ | ✅ | ✅ | — | — | 无需单独填库名 |
| SQLite | ✅ | — | — | — | — | — | 仅填"数据库地址"为文件路径/文件名 |
| SSAS | ✅ | — | ✅ | ✅ | ✅ | — | 无端口 |
| MongoDB | ✅ | ✅ | ✅ | ✅ | ✅ | — | 验证数据库（auth_source，选填） |
| ODBC | ✅ | ✅ | ✅ | ✅ | ✅ | — | ODBC 驱动（必填）、自定义连接（选填） |
| XZAPI | — | — | — | — | — | — | API 访问地址、接口 KEY、接口 Secret（均必填） |
说明：「数据库名称」在多数类型中支持点击右侧 「获取列表」，由平台根据已填地址 / 账号自动拉取可访问的库列表供选择。
4.4 关系型数据库连接创建
4.4.1 创建 SQL Server 数据库连接
适用于 Microsoft SQL Server，也是对接用友 U8、金蝶等 ERP 后台库的常见类型。
填写字段：
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义，如"ERP数据库" |
| 数据库类型 | ✅ | 选择 SQL Server |
| 数据库地址 | ✅ | 服务器 IP 或主机名，如 127.0.0.1 |
| 数据库端口 | ✅ | 默认 1433 |
| 用户名 | ✅ | 数据库登录账号 |
| 密码 | ✅ | 数据库登录密码 |
| 数据库名称 | ✅ | 目标库名，如 UFDATA_001_2017；可点击"获取列表"自动拉取 |
| 软件标识 | ◻ | 若该库来自金蝶 / 用友等 ERP，可选择对应软件版本 |
| 字符集 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
操作要点：填写完地址、端口、账号、密码后，先点「获取列表」自动拉取数据库名称，再「连接测试」→「确定」。
📷 配图建议 5：SQL Server 类型填写完整后的对话框截图（示例：ERP数据库 / 127.0.0.1 / 1433 / UFDATA_001_2017）。
4.4.2 创建 MySQL 数据库连接
填写字段：连接名称、数据库类型（MySQL）、数据库地址、数据库端口（默认 3306）、用户名、密码、数据库名称（可获取列表）、软件标识（选填）、字符集（选填）、备注（选填）。必填项与 SQL Server 一致。
4.4.3 创建 Oracle 数据库连接
填写字段：连接名称、数据库类型（Oracle）、数据库地址、数据库端口（默认 1521）、用户名、密码、数据库名称（即服务名 / SID）、软件标识、字符集、备注。
4.4.4 创建 MariaDB 数据库连接
字段与 MySQL 完全一致，端口默认 3306。
4.4.5 创建 PostgreSQL 数据库连接
填写字段：连接名称、数据库类型（PostgreSQL）、数据库地址、数据库端口（默认 5432）、用户名、密码、数据库名称、软件标识、备注。（无字符集项）
4.4.6 创建 DB2 / DB2/AS400 数据库连接
填写字段：连接名称、数据库类型（DB2 或 DB2/AS400）、数据库地址、数据库端口、用户名、密码、数据库名称、软件标识、字符集、备注。两者字段一致，按实际数据库选型即可。
4.5 国产数据库连接创建
信创场景下常用的三类国产数据库，字段结构与 PostgreSQL 类似。
4.5.1 创建人大金仓数据库连接
填写字段：连接名称、数据库类型（人大金仓）、数据库地址、数据库端口、用户名、密码、数据库名称、软件标识、备注。
4.5.2 创建达梦数据库连接
填写字段：连接名称、数据库类型（达梦）、数据库地址、数据库端口、用户名、密码、软件标识、备注。
📌 注意：达梦类型无需单独填写"数据库名称"（达梦以实例 / 模式区分，地址 + 账号即可连接）。
4.5.3 创建瀚高数据库连接
填写字段：连接名称、数据库类型（瀚高）、数据库地址、数据库端口、用户名、密码、数据库名称、软件标识、字符集、备注。
4.6 文件型数据库连接创建
4.6.1 创建 SQLite 数据库连接
SQLite 为本地文件型数据库，无需端口、用户名、密码、数据库名称。
填写字段：
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义，如"演示数据" |
| 数据库类型 | ✅ | 选择 SQLite |
| 数据库地址 | ✅ | SQLite 文件路径或文件名，如 上峰_AI演示数据.db、众德_产供销底数据.sqlite |
| 软件标识 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
📷 配图建议 6：SQLite 类型填写示例（演示数据 / server47.db）。
4.7 NoSQL / 分析 / 时序型连接创建
4.7.1 创建 MongoDB 数据库连接
特有字段：除常规地址、端口、账号、密码、数据库名称外，多一个 「验证数据库」（auth_source） 选填项——用于指定账号鉴权时所用的库（默认为 admin，若账号建在业务库则需填对应库名）。
填写字段：连接名称、数据库类型（MongoDB）、数据库地址、数据库端口（默认 27017）、用户名、密码、验证数据库（选填）、数据库名称、软件标识、备注。
4.7.2 创建 SSAS 数据库连接
SQL Server Analysis Services 多维 / 表格模型，无端口字段。
填写字段：连接名称、数据库类型（SSAS）、数据库地址、用户名、密码、数据库名称、软件标识、备注。
4.7.3 创建 InfluxDB 数据库连接
时序数据库。
填写字段：连接名称、数据库类型（InfluxDB）、数据库地址、数据库端口（默认 8086）、用户名、密码、数据库名称、软件标识、字符集、备注。
4.7.4 创建 ElasticSearch 数据库连接
填写字段：连接名称、数据库类型（ElasticSearch）、数据库地址、数据库端口（默认 9200）、用户名、密码、数据库名称、软件标识、字符集、备注。
4.7.5 创建 SAP HANA 数据库连接
填写字段：连接名称、数据库类型（SAP HANA）、数据库地址、数据库端口（默认 39015 或按实例）、用户名、密码、数据库名称、软件标识、字符集、备注。
4.8 接口 / 通用型连接创建
4.8.1 创建 XZAPI（平台 API 数据源）连接
用于对接平台支持的 API 形态数据源，字段结构与其他类型差异最大，无端口、无传统库名。
填写字段：
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库类型 | ✅ | 选择 XZAPI |
| API 访问地址 | ✅ | 接口的服务地址 |
| 接口 KEY | ✅ | 接口鉴权 KEY |
| 接口 Secret | ✅ | 接口鉴权 Secret |
| 软件标识 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
4.8.2 创建 ODBC 数据库连接
通过 ODBC 通用驱动接入未直接列举的数据库，扩展性最强。
填写字段：
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 连接名称 | ✅ | 自定义 |
| 数据库类型 | ✅ | 选择 ODBC |
| ODBC 驱动 | ✅ | 选择已安装的 ODBC 驱动程序 |
| 自定义连接 | ◻ | 自定义连接串 / 连接参数 |
| 数据库地址 | ✅ | 服务器地址 |
| 数据库端口 | ✅ | 端口 |
| 用户名 | ✅ | 登录账号 |
| 密码 | ✅ | 登录密码 |
| 数据库名称 | ✅ | 目标库名 |
| 软件标识 | ◻ | 按需选择 |
| 备注 | ◻ | 自由备注 |
4.9 关于「软件标识」
「软件标识」是一个全类型通用选填项，用于标注该连接对应业务系统的软件类型与版本。当数据库来自标准 ERP 时，选择对应版本有助于平台识别其业务表结构、辅助自动建模。
目前「软件标识」可选的 ERP 软件版本包括：
| 厂商 | 可选版本 |
|---|---|
| 金蝶 | 金蝶云星空V7.5、金蝶EAS_V5.4、金蝶EAS_V7.0、金蝶EAS_V8.0、金蝶EAS_V8.2、金蝶EAS_V8.5、金蝶K3WISE、金蝶KIS旗舰 |
| 用友 | 用友NC5.7、用友NC6.3、用友T+13.0 |
📷 配图建议 7：「软件标识」下拉框展开截图，展示金蝶 / 用友各版本选项。
5. 常见问题
| 问题 | 解决建议 |
|---|---|
| 连接测试失败 | ① 核对地址、端口是否正确；② 确认账号密码无误且具备库访问权限；③ 确认数据库对平台服务器网络可达（防火墙 / 白名单）；④ 字符集是否匹配 |
| 「获取列表」拉不到库名 | 先确认地址 + 账号 + 密码已正确填写并能通过连接测试，再重新点击获取 |
| SQLite 连接不上 | 核对文件路径 / 文件名是否正确，文件是否已上传至平台可访问的位置 |
| 删除连接时提示已被引用 | 先到数据模型 / 报表 / 智能问数中解除对该连接的引用，再执行删除 |
| 国产库 / 达梦连不上 | 达梦无需填库名；人大金仓 / 瀚高参照 PostgreSQL 字段核对端口与模式 |
附录：字段速查（按输入项）
| 字段（输入项） | 含义 | 适用类型 |
|---|---|---|
| 连接名称 | 连接显示名 | 全部类型 |
| 数据库地址 / host | 服务器地址或文件路径 | 除 XZAPI 外几乎全部 |
| 数据库端口 / port | 服务端口 | 关系型、国产、MongoDB、InfluxDB、ES、SAP HANA、ODBC |
| 用户名 / username | 登录账号（XZAPI 中为"接口 KEY"） | 除 SQLite 外的全部 |
| 密码 / password | 登录密码（XZAPI 中为"接口 Secret"） | 除 SQLite 外的全部 |
| 数据库名称 / db_name | 目标库名 | 多数关系型 / 国产 / NoSQL / 时序型 |
| 验证数据库 / auth_source | MongoDB 鉴权库 | 仅 MongoDB |
| ODBC 驱动 / odbc_driver | ODBC 驱动程序 | 仅 ODBC |
| 自定义连接 | 自定义连接串 | 仅 ODBC |
| 软件标识 / soft_version | ERP 软件版本标注 | 全部类型（选填） |
| 字符集 / charset | 字符编码 | SQL Server、MySQL、Oracle、MariaDB、DB2、InfluxDB、ES、SAP HANA、瀚高 等 |
| 备注 | 自由文本说明 | 全部类型（选填） |
本文档基于安捷智用 AI 应用平台【企业门户】体验组织实际界面整理，如平台版本升级导致界面变化，请以实际系统为准。