字典是口径的出处
指标字典面向全公司发布,支持按业务域、关键词、别名检索,卡片上展示口径、公式、来源表、负责人、示例 SQL 与血缘入口,并支持变更订阅。字典是口径的权威来源,报表与看板都应附上字典链接,用户看完数字能直接跳到定义。字典与指标平台之间要双向同步,不允许存在字典之外的正式指标,否则治理流程会被逐步绕开。
基本信息
| 检索 | 按业务域、关键词、别名 |
|---|---|
| 卡片内容 | 口径、公式、示例、血缘入口 |
| 字段 | 编码、名称、别名、域、负责人、版本、状态 |
| 订阅 | 口径变更通知 |
| 权威性 | 字典是口径的唯一出处 |
典型使用场景
- 分析师查指标时先看字典,避免重复定义与口径误用
- 报表与看板附字典链接,减少口径问答的沟通成本
- 新人上手:通过字典理解业务指标的全貌
- 口径变更时向订阅者推送通知
- 定期巡检:找出长期无人访问的指标,进入下线评估
- 与权限体系联动:能查到指标定义不等于能看到明细数据
字典字段
字典字段
# 字典字段示例
metric_code, name, alias[], domain, formula,
source_tables[], owner, version, status
# 状态:draft / published / deprecated
# 检索:编码、中文名、别名都能命中同一条目
# 报表侧附带字典链接,用户可直接查看口径要素要求
| 要素 | 要求 | 缺失的后果 |
|---|---|---|
| 别名 | 登记口语叫法 | 用户搜不到,口径重新分裂 |
| 负责人 | 填到具体的人 | 变更时无人确认 |
| 版本与状态 | 标识在用或已废弃 | 用户不知道指标是否还有效 |
| 血缘入口 | 可跳转到上下游 | 排查时需要人工问人 |
字典与平台必须双向同步:允许存在字典之外的正式指标,就等于允许绕开治理流程,前面做的口径治理会被逐步架空。
订阅通知要能追到人:口径变更时推送给看过该指标的用户与相关报表负责人,比群发一份变更公告有效得多。