口径变了要发版本
指标口径发生变化时要发新版本，并在一段时间内保留旧版本的取数能力：双跑对账确认差异、向消费方发出通知、设定旧版本退场日期。直接改口径不发版本，会让同比曲线在变更点断裂，下游多半会误判成数据故障，排查一圈才发现是口径换了。版本信息应体现在接口返回、指标卡与看板标题上，让消费方随时知道自己在看哪一版。
基本信息
| 触发条件 | 语义变化、修复错误、口径细化 |
|---|---|
| 过渡手段 | 新旧双跑、差异说明、通知 |
| 退场 | 公告加期限，到期停止维护 |
| 可见性 | 接口与卡片返回版本号 |
| 禁止事项 | 静默修改口径 |
典型使用场景
- 口径细化（例如剔除内部订单）时发新版本并说明影响量级
- 修复历史计算错误时保留旧版本，便于复盘与对比
- 对外披露口径调整，提前通知消费方并留出过渡期
- 双跑期间用差异报表展示两版数字，帮助用户理解变化
- 旧版本退场前确认已无下游引用，避免报表突然无数据
版本共存与双跑
版本共存与双跑
-- 同一指标编码携带版本，支持并行取数
SELECT dt, metric_version, value
FROM metric_daily
WHERE metric_code = 'GMV' AND dt = '2026-10-12';
-- 双跑差异：新旧版本同分区对比
SELECT a.dt, a.value AS v_old, b.value AS v_new, b.value - a.value AS diff
FROM metric_daily a
JOIN metric_daily b
ON a.metric_code = b.metric_code AND a.dt = b.dt
WHERE a.metric_version = 'v1' AND b.metric_version = 'v2';场景与处理
| 场景 | 处理方式 | 不处理的风险 |
|---|---|---|
| 口径细化 | 发新版本并双跑 | 同比在变更点断裂 |
| 计算纠错 | 新旧并存并说明 | 历史结论无法复盘 |
| 对外披露 | 提前通知加过渡期 | 消费方误判为故障 |
| 版本退场 | 公告期限后停维护 | 报表突然取不到数据 |
版本双跑要有明确期限：长期双跑会让用户在两套数字之间反复摇摆，反而加重口径混乱，通常设定一到两个评估周期。
版本号要透出到消费端：报表标题、接口返回与导出文件都应带版本标识，否则同一份报表的两张截图可能对应不同口径。