跳到主要内容

数据连接数据集

数据连接数据集选择一张数据库表或已配置的表单模型作为主来源,关联其他来源,再组织字段供图表和 API 使用。

创建数据集​

  1. 打开 数据连接 → 数据集,新建数据集。
  2. 填写名称,选择数据源。
  3. 从已保存的来源目录中选择主表或表单模型。
  4. 按需配置关联,创建数据集。
  5. 打开数据集,检查字段,通过 数据预览 确认结果。

使用表单模型时,需要先配置可用的数据读取规则。直接使用普通物理表时,无需先创建表单模型。

编辑来源与关联关系​

点击顶部刷新按钮右侧的 编辑,打开关联关系编辑弹窗。

选择主来源、添加关联来源,并指定每条关联的左侧来源。通过对应字段配置关联条件。字段选择器区分数据集列和表单字段,也可以展示表单数据读取规则所使用的来源表及可用的已添加字段。

关联方式结果
左关联保留左侧所有行,没有匹配时右侧字段为空
内关联只保留两侧匹配的行
右关联保留右侧所有行,没有匹配时左侧字段为空
全关联保留两侧的行,包括没有匹配的行

MySQL 和 MariaDB 在此配置中不支持全关联。一个数据集最多支持 12 条有序关联。一对多关联会重复主表值,请在预览中核对汇总和计数。

应用弹窗配置会更新草稿。保存数据集后,变更才会用于后续查询。

管理字段​

在字段列表中调整名称、维度/指标、聚合方式、可见性及支持的字段选项。修改显示名称不会改变字段本身的标识。

JSON/XML 字段会显示对应类型。配置好的标量子字段可进入数据集,并在图表字段选择器中按层级选择。此功能不展开数组子字段。

添加计算字段​

打开 编辑,使用关联关系编辑弹窗中的自定义列按钮。

  1. 填写稳定的字段编码和显示名称。
  2. 选择支持的数据类型。
  3. 选择表达式或 Studio 脚本作为取值来源。
  4. 完成字段配置,应用弹窗。
  5. 保存数据集。

表达式通过支持的公式语言计算数据集字段,不能直接执行任意 SQL。

Studio 脚本 字段是由可视化绑定脚本赋值的占位字段。选择此来源不会让 API 为每条记录执行脚本;数据库查询对该字段返回 null,适用的图表脚本再为它赋值。

最多可配置 80 个计算字段。修改类型或取值来源时,如果希望保留该字段的 API 授权,应保留原字段编码。

刷新结构并处理失效字段​

来源元数据变更后:

  1. 按变更内容重新扫描数据库结构或表单定义。
  2. 打开数据集,点击 刷新结构。
  3. 检查新增字段、失效字段以及缺失或失效的关联。
  4. 修复映射,按可用操作隐藏或移除废弃字段,并保存。
  5. 预览保存后的结果。

可编辑配置和刷新后的结构都没有变化时,重新进入数据集无需再次保存。数据预览要求当前草稿和结构变更已保存。

使用数据集​

在 可视化 中选择已保存的数据集。图表预览支持显示字段的展示值,例如关联名称;过滤和匹配继续使用底层值。

内部成员的字段和数据范围权限通过数据集权限设置管理。API 角色则在 API 服务中单独配置。

数据集被图表使用时,需要先处理图表依赖才能删除。删除数据集后,API 角色中该数据集的绑定也会移除,其他数据集绑定保留。

在角色权限编辑器中允许数据集可见时,会在草稿中为该数据集已启用且可授权的字段填入查看权限;保存前应检查字段范围。字段对话框将 JSON/XML 子字段按父文档分组,字段权限与行范围仍然生效。