01
名称:稳定且不含临时缩写
02
含义:业务定义和例子
03
粒度:一行或一个值代表什么
04
质量:空值、枚举和更新
05
权限:是否含敏感信息
先给结论:命名统一不等于语义统一
把“gmv_amt”改成“成交金额”只能改善可读性,不能解决含税、退款、时间和粒度问题。AI 友好字段需要名称、定义、示例值、数据类型、粒度、更新时间和责任人。
字段命名应服务于指标与问题,而不是追求一套看起来整齐的词汇。
避免缩写、复用和隐含过滤
同一个“status”在订单、支付和物流表里含义不同;“active”可能代表登录、有效合同或可售商品。字段描述应明确枚举、默认过滤和例外。
金额字段还要说明币种、税、折扣和精度;日期字段要说明时区和业务事件。
让字段元数据可测试
将字段字典纳入版本管理,测试类型、唯一性、枚举变化、空值比例和更新时间。BuildTable 的 AI 友好建模方向可作为整理候选,具体元数据和发布能力需项目确认。
字段变更应通知指标、报告和智能体负责人。
用真实问题反验命名
用十个业务问题测试:业务人员能否从描述理解字段,模型是否选择正确列,结果能否解释。命名不应脱离问题集单独评审。
