数据源配置
一句话:登记「别的数据库的连接信息」(名称 / 连接串 / 用户名 / 密码)。列表里编号 0 那行是主数据源(本系统自己的库),不可编辑、不可删除;你在这里登记的外部库,会出现在「表单设计器 → 数据表绑定」的数据源下拉里,供表单绑定外部库的表。
功能在哪
- 菜单路径:基础设施 → 数据管理 → 数据源配置
- 地址栏路由:
/infra/data-manage/data-source-config - 主要权限:
infra:data-source-config:create/update/delete

界面认识
| 区域 | 作用 | 常用操作 |
|---|---|---|
| 工具条 | 整页级动作 | 「新增」;勾选后「批量删除」 |
| 列表 | 序号 / 数据源名称 / 数据源连接 / 用户名 / 创建时间 / 操作 | 行内「编辑」「删除」 |
| 主数据源行 | 编号 0,本系统自己的库 | 编辑 / 删除置灰,勾选批量删除时也会被自动过滤 |
本页没有查询区——数据源数量通常很少,直接看列表即可。列表不显示密码,也不显示主键编号:数据源是拿名称认的。
常用操作
新增一个数据源
- 点「新增」;
- 填「数据源名称」——后续选择数据源时靠它认;
- 填「数据源连接」——标准 JDBC 连接串,如
jdbc:mysql://127.0.0.1:3306/report_demo?useSSL=false&serverTimezone=Asia/Shanghai; - 填「用户名」「密码」;
- 点「确 定」。
结果:列表多一行。密码加密落库(AES),任何界面都不会回显明文。

编辑 / 删除 / 批量删除
- 行内「编辑」改连接或账号密码;
- 行内「删除」或勾选后「批量删除」,确认框为「是否删除所选中数据?」(标题「系统提示」);
- 主数据源不能删也不能改——它是平台自身在用的连接,界面上直接置灰,不给你点错的机会。
删除前确认没有表单在用
已发布的表单会记住自己绑定的数据源编号;删掉仍被引用的数据源,表单发布校验会直接报「数据源配置不存在」,运行时也取不到数。先把相关表单改绑到别的数据源或下线,再删。
谁在用这些数据源
| 功能 | 是否可选外部数据源 | 说明 |
|---|---|---|
| 表单设计器(数据绑定步骤) | 可以 | 「数据源」下拉里 0 表示主库,其余来自本页;主表、副表、明细表必须在同一个数据源里 |
| 代码生成(导入表) | 可以 | 按所选数据源读取表清单 |
| 数据模型 | 不可以 | 建模与 DDL 固定在主数据源执行 |
| 接口管理 | 不可以 | SQL 在主数据源上执行 |
| 数据查看 | 不可以 | 查看的是数据模型对应的表,随模型固定在主数据源 |
字段说明
| 字段 | 必填 | 校验 | 说明 |
|---|---|---|---|
| 数据源名称 | 是 | 「数据源名称不能为空」 | 认数据源的依据 |
| 数据源连接 | 是 | 「数据源连接不能为空」 | JDBC 连接串 |
| 用户名 | 是 | 「用户名不能为空」 | 数据库账号 |
| 密码 | 是 | 「密码不能为空」 | 加密落库,不回显明文 |
视角对照
| 视角 | 看到什么 |
|---|---|
超管 admin / 租户管理员 docadmin | 全部数据源,可增删改 |
| 套餐未含此菜单的租户 | 侧边栏「数据管理」下没有本页 |
| 普通员工 | 无此菜单;数据源是运维向配置 |
进阶
- 连接串写错的后果:保存本身不校验连通性;真正连不上时,用到它的功能会报「数据源配置不正确,无法进行连接」;
- 数据模型当前仅支持 MySQL 数据源(其它库类型会被拒绝建模);
- 密码采用与框架一致的字段级 AES 加密:直接改数据库里的密文请用平台密钥,手填明文会导致读取时报错。
常见问题
Q:主数据源为什么不能编辑? A:编号 0 的主数据源就是本系统自己的库,连接信息由服务端配置决定,不在本页维护;置灰是刻意为之。
Q:新增后在哪里能选到它? A:在「表单设计器 → 数据绑定」的「数据源」下拉里(0 是主库,其余就是本页登记的),以及代码生成的导入表选择里。数据模型、接口管理、数据查看当前固定在主数据源上,选不到。
Q:表单能一半表在主库、一半在外部库吗? A:不能。设计器里写得很明白:主表、副表、明细表必须在同一个数据源里——跨库没法用同一个事务,一半写成功一半失败时无从回滚。
Q:密码忘了能查看吗? A:不能。密码加密落库且界面不回显明文;忘了就直接编辑重填。
Q:能配只读账号吗? A:能且建议:给外部库登记一个只读账号,可以从源头上避免误写对方库。
