实体(object)

基本说明

实体类型用于关联其他 Schema,实现表与表之间的连接。例如订单关联用户、销售关联店铺、员工关联部门。关联后,可以使用目标表中的名称和其他属性进行筛选、分组与分析。

数据要求

  • 被关联的表需要有且只有一个 ID 属性,供系统找到对应记录。
  • 实体字段映射后的值需要对应关联表的 ID。例如店铺表中人民路店的 ID 为 SH0089,订单中的「店铺」字段映射后也应为 SH0089。
  • 原始字段与关联表的 ID 类型或编号格式不一致时,可以通过字段高级设置统一,无需修改原表。

配置与问答

  1. 在目标表中配置 ID、名称以及需要分析的属性。
  2. 将源表中的外键字段设为「实体」,选择对应的目标 Schema。
  3. 将业务字段名设为「用户」「店铺」「员工」等,便于自然语言识别,无需保留数据库中的 xxId 命名。
  4. 学习相关名称、分类等字段后,使用目标实体的名称或属性提问。

实体关系可以连续连接,例如「订单 → 店铺 → 地区」,从订单分析店铺所在地区。配置方式也可参见 Schema 类型。

使用示例

用户(实体表)

id名称年龄
001张三20
002李四21
003王二24

销售(事件表)

时间用户金额
2025-05-31001100
2025-05-10002420
2025-06-02001210

销售表中的「用户」字段设为实体类型并关联用户表,保存的 001 对应用户表中的张三。若金额配置为可加指标,提问「张三的金额」,会得到 100 + 210 = 310。

常见问题

设置为实体后,为什么查看数据时没有正常展示?

先检查映射后的值能否匹配到关联表的 ID,包括类型、前导零、大小写和空格。原始数据格式不同,可以在映射中统一。找不到对应记录时,系统会返回缺失实体的占位对象,具体规则见 Schema 与语义类型。

可以直接保存目标实体的名称吗?

取决于目标 ID。例如目标 ID 为 001、名称为「张三」,就必须保存 001;如果目标 ID 本身就是「张三」,才保存「张三」。

与 ID 类型有什么区别?

ID 标识当前对象,实体字段引用另一个对象。订单的「订单编号」可以是 ID,「用户」则是指向用户表的实体字段。