常用语义类型实例

本章节以三张经典业务表为例,展示各类语义类型的实际用法。三张表分别为两张实体表(企业人员、店铺)和一张事件表(订单),覆盖了系统支持的全部 18 种语义类型,帮助理解模型中的属性需要选中的语义类型。

实体表:企业人员(employee)

字段中文名语义类型说明
employee_id编号ID主键,唯一标识
employee_name姓名中国人名中文姓名
gender性别分类男 / 女
phone手机号字符串11 位手机号,可配置正则校验
department部门实体未列出实体,可关联到部门实体表
entry_date入职日期日期格式 YYYY-MM-DD
avatar头像图像员工照片 URL,查询时会以图片形式展示

实体表:店铺(store)

字段中文名语义类型说明
store_id编码ID主键,唯一标识
store_name店铺名称名称通用名称类型,内容会被系统学习,支持搜索
channel渠道分类线上 / 线下,内容会被系统学习
open_date开店日期生效时间生效时间
close_date闭店日期失效时间失效时间(可空)
area面积整数平方米
store_rating评分数值1.0 ~ 5.0,小数评分
tags标签标签旗舰店 / 社区店 / 快闪店 等,数组存储,会被系统学习
store_photo门店照片图像门面照片 URL,查询时会以图片形式展示

事件表:订单(order)

字段中文名语义类型说明
order_id订单编号ID主键,可被其他 Schema 以实体形式关联
order_time交易时间时间戳事件发生时间,格式 YYYY-MM-DD HH:mm:ss
store店铺实体存储店铺表的 ID,关联后可下钻分析店铺的所有维度
employee员工实体存储企业人员表的 ID,关联后可下钻分析员工的所有维度
quantity销售量整数销售数量
amount销售额货币交易金额(元)
discount_rate折扣率百分比0.00 ~ 1.00,一般建议通过指标定义计算
delivery_duration配送时长时长单位:分钟(默认为秒)
is_returned是否退货布尔值是 / 否

各类型使用要点

ID

仅作为记录的唯一标识。如需支持按编号搜索,可在字段中配置正则表达式。若设置为ID,则可被其他 Schema 以实体形式连接;

名称、分类、标签

数据库中的内容会被系统自动学习,用户可直接搜索具体的名称、分类或标签值。

图像

当查询命中具体数据时,系统会在结果中直接渲染为图片展示。

实体

本字段需存储目标 Schema 的 ID 数据,这一点容易遗漏——字段里存的值必须是目标表中真实存在的 ID,否则关联不上。实体关联后,可在知识图谱中可视化 Schema 之间的关系,支持连续关联(如 订单 → 店铺 → 实体表的地理位置字段),关联到的实体表下所有可分析子维度均可用于归因与问答。

常见问题

设置了实体字段但查看数据时该列无内容,多半是因为字段中保存的值在目标表 ID 中找不到匹配记录,关联失败导致。

命名建议

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

布尔值

字段命名建议以 "是否 xx" 格式,例如"是否完成"。系统能正确理解"上月已完成"和"上月未完成"两种表述的逻辑。

时间戳与其他日期类型

  • 时间戳:通常仅在事件表中存在一个,表示事件发生时间。
  • 实体表中的日期字段以及事件表中除时间戳外的其他时间字段,统一设置为日期类型即可。

百分比

允许在字段中直接存储百分比值。但涉及范围聚合分析(如"上月利润率")时,直接对该列做 SUM()AVG() 均不合逻辑。这类指标应通过指标定义配置分子和分母来计算,系统自动处理后即可灵活组合各种统计维度,无需再按传统 BI 方式为各个维度单独创建 ADS 表。详见指标配置