实体(object)
基本说明
实体类型用于关联其他 Schema,实现表与表之间的连接。例如订单关联用户、销售关联店铺、员工关联部门。关联后,可以使用目标表中的名称和其他属性进行筛选、分组与分析。
数据要求
- 被关联的表需要有且只有一个 ID 属性,供系统找到对应记录。
- 实体字段映射后的值需要对应关联表的 ID。例如店铺表中人民路店的 ID 为
SH0089,订单中的「店铺」字段映射后也应为SH0089。 - 原始字段与关联表的 ID 类型或编号格式不一致时,可以通过字段高级设置统一,无需修改原表。
配置与问答
- 在目标表中配置 ID、名称以及需要分析的属性。
- 将源表中的外键字段设为「实体」,选择对应的目标 Schema。
- 将业务字段名设为「用户」「店铺」「员工」等,便于自然语言识别,无需保留数据库中的
xxId命名。 - 学习相关名称、分类等字段后,使用目标实体的名称或属性提问。
实体关系可以连续连接,例如「订单 → 店铺 → 地区」,从订单分析店铺所在地区。配置方式也可参见 Schema 类型。
使用示例
用户(实体表)
销售(事件表)
销售表中的「用户」字段设为实体类型并关联用户表,保存的 001 对应用户表中的张三。若金额配置为可加指标,提问「张三的金额」,会得到 100 + 210 = 310。
常见问题
设置为实体后,为什么查看数据时没有正常展示?
先检查映射后的值能否匹配到关联表的 ID,包括类型、前导零、大小写和空格。原始数据格式不同,可以在映射中统一。找不到对应记录时,系统会返回缺失实体的占位对象,具体规则见 Schema 与语义类型。
可以直接保存目标实体的名称吗?
取决于目标 ID。例如目标 ID 为 001、名称为「张三」,就必须保存 001;如果目标 ID 本身就是「张三」,才保存「张三」。
与 ID 类型有什么区别?
ID 标识当前对象,实体字段引用另一个对象。订单的「订单编号」可以是 ID,「用户」则是指向用户表的实体字段。

