跳到主要内容

数据连接

数据连接用于读取外部数据库,将数据库表或应用中定义的表单组织为数据集,再提供给图表和经过授权的 API 客户端。

在 Soln 中打开 集成应用 → 数据连接。可用功能取决于订阅和工作区权限。执行连接的租户 Runtime 必须能访问数据库地址。

选择接入方式​

数据存储情况建议方式
一张数据库表已经包含所需数据扫描数据库结构,直接从表创建数据集
应用将表单定义与业务记录分别存储扫描表单和字段定义,配置数据读取,再从表单模型创建数据集
字段值存放在 JSON/XML、共享记录表或多张关联表中先配置表单模型的数据读取规则,再创建数据集
外部应用需要受控访问已保存的数据集创建 API 服务,为角色绑定数据集,再发放 API Key

配置流程​

  1. 连接数据源并扫描结构。
  2. 如果应用使用可配置表单,扫描表单和字段定义。
  3. 如果关联关系存放在应用配置中,扫描关系定义。
  4. 配置业务记录和字段值的读取规则。
  5. 创建数据集并预览。
  6. 在可视化中使用数据集,或配置 API 服务。

直接使用物理表创建数据集时,可以跳过第 2~4 步。

各项配置的作用​

配置作用
数据源数据库引擎、地址、凭据和 TLS 设置
结构快照保存数据库模式、表、列、键和关系的结构描述
表单定义扫描读取表单和字段的名称、编码、类型、选项等元数据
关系定义扫描读取哪些表单和字段关联到其他表单和字段
数据读取规则指定表单的业务记录和字段值实际存储在哪里
数据集选择主表、关联来源,配置字段和计算字段
API 角色配置数据集、可读字段、数据范围及单独开启的写入权限
API Key绑定一个 API 服务和一个 API 角色的调用凭据

定义扫描读取的是元数据,不会将业务记录导入 Soln。使用数据集查询时,才会读取来源数据库。

变更与权限​

保存数据集不会自动授予内部成员使用权限。成员数据集权限与 API 角色需要分别配置。

API 角色使用最新保存的数据集。新增字段自动获得读取权限,删除字段会移除对应授权;修改主表或关联关系后,该数据集绑定会重置为全部可用字段、仅允许查询。修改已被外部调用的数据集前,请了解数据集变更与授权。

问题排查入口​

  • 连接失败:检查数据源连接测试和 TLS 设置。
  • 字段缺失或类型不正确:检查物理结构、表单定义扫描和字段类型映射。
  • 字段值为空:检查表单的数据读取规则和数据预览。
  • 汇总重复:检查每行代表的内容,以及一对多关联。
  • API 调用失败:打开 API 服务的 调用日志,在详情中查看原始错误。

使用 AI 分析结构​

打开数据源表或配置页面后,可以让助手分析当前结构或解释候选关联。它能够读取结构快照、检查有界样本、双向验证候选关联,并预览受支持的读取规则。让助手更新持久化配置前,应先保存或放弃当前未保存修改。

样本只能提供观察证据,不能证明全表唯一性或业务含义。创建数据集前,先确定一行代表什么,保留完整身份键,并检查关联是否重复金额或计数。物理表可直接创建数据集;不需要额外映射时,无需先创建定义扫描或表单模型。支持的流程和限制见数据连接命令参考。