数据源维护
「数据源维护」是积木报表工作台中集中管理所有数据源的入口，统一维护报表与大屏用到的数据库连接，并为 AI 能力提供表结构元数据。
入口：报表工作台（
/jmreport/list）左侧菜单 数据源维护。
一、它是做什么用的
平时新增数据源是在「SQL 数据集」配置弹窗里点「维护」逐个添加（参见 添加数据源）。当数据源越来越多、又分散在不同报表和大屏里时，就需要一个集中的地方统一查看和管理——这就是「数据源维护」。
它主要解决三件事：
- 集中查看所有数据源：把报表（
报表）和大屏（大屏）用到的数据源汇总到一张列表，并标明每个数据源的来源，另外还会展示应用自带的「系统数据源」（内置）。 - 统一维护连接信息：随时修改数据源的名称、类型、驱动、地址、账号密码，并可在线测试连通性。
- 同步并管理元数据：把数据库的表结构（表、字段、注释、关联关系）同步进来，供 AI 助手「一句话生成报表/SQL」时理解你的库表（参见 AI 助手）。
二、数据源列表
进入「数据源维护」后，可以看到所有数据源的列表：
列表说明：
| 列 | 说明 |
|---|---|
| 序号 | 数据源序号；首行固定为「系统数据源」（应用内置，不可删除/编辑） |
| 数据源名称 | 数据源名称 |
| 数据库类型 | 如 MySQL5.7、es、mongodb、kingbase8、other 等 |
| 数据来源 | 该数据源由「报表」还是「大屏」创建 |
| 操作 | 同步元数据 / 元数据 / 编辑 |
顶部支持按数据源名称搜索、按数据来源筛选，并分页展示。
三、编辑数据源连接
点击某行的「编辑」，可修改连接信息并测试连通性：
| 字段 | 必填 | 说明 |
|---|---|---|
| 数据源名称 | 是 | 数据源显示名称 |
| 数据源类型 | 是 | 选择数据库类型，详见 数据库支持类型 |
| 驱动类 | 是 | JDBC 驱动类名，如 com.mysql.cj.jdbc.Driver |
| 数据源地址 | 是 | JDBC 连接地址 |
| 用户名 | 否 | 数据库账号 |
| 密码 | 否 | 数据库密码 |
编辑时密码留空表示不修改，测试和保存均沿用原密码。点「测试」可校验连接是否成功，确认无误后点「确定」保存。
四、同步元数据
点击「同步元数据」，确认后会从该数据源读取最新的表结构信息：
同步采用「刷新结构 + 合并关系」策略，对已存在的表：
- 字段（列）/ 源库注释：以源库最新结构为准，每次同步刷新；
- 关联关系：把源库外键与平台中已有的关联合并去重，不会覆盖你在「元数据管理」里手动维护的逻辑关联，或历史 JOIN 推断出的关系；
- LLM 可见：保留你的开关设置，不会被同步重置；
弹窗提示的「覆盖现有的表结构信息」指的是表、字段、源库注释会以源库为准刷新；你手动维护的「关联关系」与「LLM 可见」开关不会被覆盖，可放心同步。
五、元数据管理（AI 表元数据）
点击「元数据」，进入「AI 表元数据管理」，查看和维护同步进来的表结构。这些元数据会作为上下文「喂给 LLM」，让 AI 助手在生成 SQL时更懂你的业务库表。
| 列 | 说明 |
|---|---|
| 表名 | 数据库表名 |
| 源库注释 | 来自数据库的表注释 |
| AI 描述 | 点击编辑，自定义对该表的业务描述，喂给 LLM 帮助其理解 |
| 列数 | 该表字段数，可点「编辑」维护字段级描述 |
| 关联关系 | 与其他表的关联关系条数，可点「编辑」维护；再次同步时会与源库外键合并去重，手动维护的关联不会丢失 |
| LLM 可见 | 开关，控制该表是否对 AI 可见（关闭后 AI 不会使用该表） |
| 更新时间 | 元数据最近同步/修改时间 |
支持按表名模糊搜索，以及批量启用 / 批量禁用「LLM 可见」。
若希望 AI 助手只针对部分核心表生成 SQL，可在此关闭无关表的「LLM 可见」，并为关键表补充「AI 描述」与「关联关系」，AI 生成的结果会更准确。