给计算变量加业务语义是将计算逻辑与业务含义绑定，使其可搜索、可理解、可复用；需标注业务定义、归属、合规治理属性及技术上下文，并在平台中通过元数据扩展落地，且须联动BI、搜索、通知与RAG等场景持续演进。
给计算变量加业务语义，本质是把“这个变量怎么算”和“这个变量代表什么业务含义”连起来。它不是单纯写个注释，而是让变量在数据平台里可被搜索、可被理解、可被复用——比如看到 ${sales_amount_net}，系统能自动告诉你：这是“不含税净销售额”，归属财务域，敏感等级为L2，负责人是张经理，上游来自ERP的invoice_line表。
明确变量的元数据维度
一个计算变量要承载业务语义，至少需标注四类信息：
- 业务定义：用自然语言说明变量的实际含义，避免技术缩写。例如，“月度活跃用户（MAU）”应标注为“当月内至少启动APP或访问H5页面一次的独立去重用户数，不含测试账号与内部员工”
- 业务归属：所属业务域（如“营销中心”“供应链管理”）、指标类型（如“过程指标”“结果指标”）、统计粒度（如“按日汇总”“按客户ID聚合”）
- 合规与治理属性：数据敏感度（如“含身份证号片段”需标为“高敏”）、是否满足GDPR/等保要求、是否通过法务审核
-
技术上下文：计算逻辑摘要（非完整SQL，而是“基于订单表+用户行为日志关联后去重计数”）、更新频率、血缘上游实体（如Dataset:
ods_order_detail）、下游消费方（如Dashboard: “销售看板V3”）
在主流平台中落地标注
不同平台操作路径略有差异，但核心都是将变量作为元数据实体进行扩展：
-
DataHub：把变量建模为
ComputedField实体（需先扩展PDL模型），再为其绑定自定义切面BusinessAttributes，填入业务负责人、SLA承诺值、口径说明书链接等字段 -
OpenMetadata：利用“Custom Properties”功能，在变量对象（如Pipeline或MlModel下的Parameter）中添加键值对，如
{"biz_owner": "marketing@company.com", "definition_url": "https://wiki.company.com/mau-spec"} - 阿里DataWorks：在“数据开发 > 变量管理”中编辑变量时，直接填写“描述”字段，并勾选“启用业务标签”，从预置词库选择“客户生命周期阶段”“营收确认状态”等标准业务属性
让标注真正起作用
只填不联动，标注就只是装饰。关键在于打通使用场景：
- 在BI工具（如QuickSight、Tableau）中配置字段时，自动拉取变量的业务定义和单位，显示在字段悬停提示中
- 当用户在数据目录搜索“GMV”，系统不仅返回表字段，也返回所有含“GMV”语义的计算变量，并按“已认证口径”优先排序
- 变量被修改时，触发通知给标注中的业务负责人和下游消费方，附带变更影响分析（如“此调整将影响5个报表的QoQ增长率计算”）
- 对接RAG应用时，向大模型注入变量的完整业务上下文，而非仅原始SQL，显著降低NL2SQL生成错误率
不复杂但容易忽略：业务语义不是一次性填写的动作，而要随变量生命周期持续演进。每次口径修订、责任人变更、合规要求更新，都该同步刷新对应元数据。
