实体(object)

基本说明

实体类型用于关联其他 Schema,实现表与表之间的连接。设置为实体的字段,其存储的值必须是目标表 ID 字段中存在的值——本质上它就是指向目标表的外键。

关键约束
  • 实体字段存储的是目标表的 ID 值,不是名称、不是编码以外的其他字段。
  • 如果字段中保存的值在目标表中找不到对应记录,关联会失败,该字段在查看数据时不会展示任何内容。这是"设置了实体却看不到数据"的最常见原因。
  • 实体表的主键必须是字符串类型,不能是整数。如果是整数需要使用 udf 功能进行转化。

举例

如有两个Schema,其中一个是实体,一个是事件:

用户(实体表)

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

销售(事件表)

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

销售表中的字段用户,是一个外键,链接用户表中的主键,用于关联销售表和用户表,此时可以直接提问“张三的金额”,系统自动用销售表外键关联用户表,找到张三,然后对金额做聚合。

实体字段直接以业务概念命名(如"用户""店铺""员工"),无需沿用数据库中 xxId 的命名习惯。