Skip to content

数据源配置 ​

一句话:登记「别的数据库的连接信息」(名称 / 连接串 / 用户名 / 密码)。列表里编号 0 那行是主数据源(本系统自己的库),不可编辑、不可删除;你在这里登记的外部库,会出现在「表单设计器 → 数据表绑定」的数据源下拉里,供表单绑定外部库的表。

功能在哪 ​

  • 菜单路径:基础设施 → 数据管理 → 数据源配置
  • 地址栏路由:/infra/data-manage/data-source-config
  • 主要权限:infra:data-source-config:create / update / delete

数据源配置列表:主数据源 + 一条示例配置;主数据源行的编辑/删除置灰(租户管理员视角)

界面认识 ​

区域作用常用操作
工具条整页级动作「新增」;勾选后「批量删除」
列表序号 / 数据源名称 / 数据源连接 / 用户名 / 创建时间 / 操作行内「编辑」「删除」
主数据源行编号 0,本系统自己的库编辑 / 删除置灰,勾选批量删除时也会被自动过滤

本页没有查询区——数据源数量通常很少,直接看列表即可。列表不显示密码,也不显示主键编号:数据源是拿名称认的。

常用操作 ​

新增一个数据源 ​

  1. 点「新增」;
  2. 填「数据源名称」——后续选择数据源时靠它认;
  3. 填「数据源连接」——标准 JDBC 连接串,如 jdbc:mysql://127.0.0.1:3306/report_demo?useSSL=false&serverTimezone=Asia/Shanghai;
  4. 填「用户名」「密码」;
  5. 点「确 定」。

结果:列表多一行。密码加密落库(AES),任何界面都不会回显明文。

新增数据源表单:名称/连接/用户名/密码四项全必填(租户管理员视角)

编辑 / 删除 / 批量删除 ​

  • 行内「编辑」改连接或账号密码;
  • 行内「删除」或勾选后「批量删除」,确认框为「是否删除所选中数据?」(标题「系统提示」);
  • 主数据源不能删也不能改——它是平台自身在用的连接,界面上直接置灰,不给你点错的机会。

删除前确认没有表单在用

已发布的表单会记住自己绑定的数据源编号;删掉仍被引用的数据源,表单发布校验会直接报「数据源配置不存在」,运行时也取不到数。先把相关表单改绑到别的数据源或下线,再删。

谁在用这些数据源 ​

功能是否可选外部数据源说明
表单设计器(数据绑定步骤)可以「数据源」下拉里 0 表示主库,其余来自本页;主表、副表、明细表必须在同一个数据源里
代码生成(导入表)可以按所选数据源读取表清单
数据模型不可以建模与 DDL 固定在主数据源执行
接口管理不可以SQL 在主数据源上执行
数据查看不可以查看的是数据模型对应的表,随模型固定在主数据源

字段说明 ​

字段必填校验说明
数据源名称是「数据源名称不能为空」认数据源的依据
数据源连接是「数据源连接不能为空」JDBC 连接串
用户名是「用户名不能为空」数据库账号
密码是「密码不能为空」加密落库,不回显明文

视角对照 ​

视角看到什么
超管 admin / 租户管理员 docadmin全部数据源,可增删改
套餐未含此菜单的租户侧边栏「数据管理」下没有本页
普通员工无此菜单;数据源是运维向配置

进阶 ​

  • 连接串写错的后果:保存本身不校验连通性;真正连不上时,用到它的功能会报「数据源配置不正确,无法进行连接」;
  • 数据模型当前仅支持 MySQL 数据源(其它库类型会被拒绝建模);
  • 密码采用与框架一致的字段级 AES 加密:直接改数据库里的密文请用平台密钥,手填明文会导致读取时报错。

常见问题 ​

Q:主数据源为什么不能编辑? A:编号 0 的主数据源就是本系统自己的库,连接信息由服务端配置决定,不在本页维护;置灰是刻意为之。

Q:新增后在哪里能选到它? A:在「表单设计器 → 数据绑定」的「数据源」下拉里(0 是主库,其余就是本页登记的),以及代码生成的导入表选择里。数据模型、接口管理、数据查看当前固定在主数据源上,选不到。

Q:表单能一半表在主库、一半在外部库吗? A:不能。设计器里写得很明白:主表、副表、明细表必须在同一个数据源里——跨库没法用同一个事务,一半写成功一半失败时无从回滚。

Q:密码忘了能查看吗? A:不能。密码加密落库且界面不回显明文;忘了就直接编辑重填。

Q:能配只读账号吗? A:能且建议:给外部库登记一个只读账号,可以从源头上避免误写对方库。