字段说明最小模板
01

名称:稳定且不含临时缩写

02

含义:业务定义和例子

03

粒度:一行或一个值代表什么

04

质量:空值、枚举和更新

05

权限:是否含敏感信息

先给结论:命名统一不等于语义统一

把“gmv_amt”改成“成交金额”只能改善可读性,不能解决含税、退款、时间和粒度问题。AI 友好字段需要名称、定义、示例值、数据类型、粒度、更新时间和责任人。

字段命名应服务于指标与问题,而不是追求一套看起来整齐的词汇。

避免缩写、复用和隐含过滤

同一个“status”在订单、支付和物流表里含义不同;“active”可能代表登录、有效合同或可售商品。字段描述应明确枚举、默认过滤和例外。

金额字段还要说明币种、税、折扣和精度;日期字段要说明时区和业务事件。

让字段元数据可测试

将字段字典纳入版本管理,测试类型、唯一性、枚举变化、空值比例和更新时间。BuildTable 的 AI 友好建模方向可作为整理候选,具体元数据和发布能力需项目确认。

字段变更应通知指标、报告和智能体负责人。

用真实问题反验命名

用十个业务问题测试:业务人员能否从描述理解字段,模型是否选择正确列,结果能否解释。命名不应脱离问题集单独评审。

公开参考资料

开始构建 AI 友好的数据基础

下载 BuildTable,或联系我们讨论企业数据建模场景。

下载 BuildTable