数据连接
数据连接用于读取外部数据库,将数据库表或应用中定义的表单组织为数据集,再提供给图表和经过授权的 API 客户端。
在 Soln 中打开 集成应用 → 数据连接。可用功能取决于订阅和工作区权限。执行连接的租户 Runtime 必须能访问数据库地址。
选择接入方式
| 数据存储情况 | 建议方式 |
|---|---|
| 一张数据库表已经包含所需数据 | 扫描数据库结构,直接从表创建数据集 |
| 应用将表单定义与业务记录分别存储 | 扫描表单和字段定义,配置数据读取,再从表单模型创建数据集 |
| 字段值存放在 JSON/XML、共享记录表或多张关联表中 | 先配置表单模型的数据读取规则,再创建数据集 |
| 外部应用需要受控访问已保存的数据集 | 创建 API 服务,为角色绑定数据集,再发放 API Key |
配置流程
- 连接数据源并扫描结构。
- 如果应用使用可配置表单,扫描表单和字段定义。
- 如果关联关系存放在应用配置中,扫描关系定义。
- 配置业务记录和字段值的读取规则。
- 创建数据集并预览。
- 在可视化中使用数据集,或配置 API 服务。
直接使用物理表创建数据集时,可以跳过第 2~4 步。
各项配置的作用
| 配置 | 作用 |
|---|---|
| 数据源 | 数据库引擎、地址、凭据和 TLS 设置 |
| 结构快照 | 保存数据库模式、表、列、键和关系的结构描述 |
| 表单定义扫描 | 读取表单和字段的名称、编码、类型、选项等元数据 |
| 关系定义扫描 | 读取哪些表单和字段关联到其他表单和字段 |
| 数据读取规则 | 指定表单的业务记录和字段值实际存储在哪里 |
| 数据集 | 选择主表、关联来源,配置字段和计算字段 |
| API 角色 | 配置数据集、可读字段、数据范围及单独开启的写入权限 |
| API Key | 绑定一个 API 服务和一个 API 角色的调用凭据 |
定义扫描读取的是元数据,不会将业务记录导入 Soln。使用数据集查询时,才会读取来源数据库。
变更与权限
保存数据集不会自动授予内部成员使用权限。成员数据集权限与 API 角色需要分别配置。
API 角色使用最新保存的数据集。新增字段自动获得读取权限,删除字段会移除对应授权;修改主表或关联关系后,该数据集绑定会重置为全部可用字段、仅允许查询。修改已被外部调用的数据集前,请了解数据集变更与授权。
问题排查入口
- 连接失败:检查数据源连接测试和 TLS 设置。
- 字段缺失或类型不正确:检查物理结构、表单定义扫描和字段类型映射。
- 字段值为空:检查表单的数据读取规则和数据预览。
- 汇总重复:检查每行代表的内容,以及一对多关联。
- API 调用失败:打开 API 服务的 调用日志,在详情中查看原始错误。
使用 AI 分析结构
打开数据源表或配置页面后,可以让助手分析当前结构或解释候选关联。它能够读取结构快照、检查有界样本、双向验证候选关联,并预览受支持的读取规则。让助手更新持久化配置前,应先保存或放弃当前未保存修改。
样本只能提供观察证据,不能证明全表唯一性或业务含义。创建数据集前,先确定一行代表什么,保留完整身份键,并检查关联是否重复金额或计数。物理表可直接创建数据集;不需要额外映射时,无需先创建定义扫描或表单模型。支持的流程和限制见数据连接命令参考。