指标退役流程
指标退役要有明确的流程：先冻结（停止新增引用、在卡片上标注即将废弃），再清理下游引用（报表、调度任务、告警规则），最后归档（保留定义与只读查询能力，支撑历史报表追溯与审计）。直接删除定义会让历史报表无法解释，口径也就不可考。
基本信息
| 三个阶段 | 冻结 → 清理引用 → 归档 |
|---|---|
| 引用核查 | 依据元数据中的使用登记表逐项排查 |
| 归档要求 | 保留定义、公式与只读查询能力 |
| 通知 | 提前告知使用方并给出替代指标 |
| 决策记录 | 记录退役原因、决策人与生效时间 |
| 例外情况 | 监管与审计相关指标不轻易退役 |
典型使用场景
- 口径升级：用新指标替代旧指标，旧指标按流程退役
- 重复合并：两个同义指标合并为一个，另一个走退役
- 业务下线：对应业务停止后清理相关指标
- 僵尸清理：长期无查询的指标批量退役，降低维护成本
- 审计支撑：归档指标仍可回答历史报表当年的数值从何而来
退役前的引用核查
退役前的引用核查
SELECT report_id, report_name, owner, last_view_dt
FROM meta_metric_usage
WHERE metric_code = 'OLD_METRIC' -- 待退役指标
AND active = 1; -- 仍有活跃引用的下游必须逐个确认
SELECT metric_code, status, deprecated_at, replace_by
FROM meta_metric
WHERE status = 'frozen'; -- 冻结期内的指标清单，作为退役待办三个阶段的做法
| 阶段 | 动作 | 完成标志 |
|---|---|---|
| 冻结 | 标注状态、停止新增引用 | 卡片显示已冻结 |
| 清理引用 | 改报表、停任务、换告警 | 引用清单清零 |
| 归档 | 保留定义与只读查询 | 可回答历史口径问题 |
归档指标保留只读查询能力，满足历史报表追溯与审计：删掉定义后，一张两年前的对账单会变成无法解释的遗留物。
退役必须给出替代方案：告诉使用方「这个指标废弃了，请改用另一个」，比单纯通知废弃更容易推动迁移；没有替代方案的指标往往被使用方原样复制一份继续使用。