口径卡片的作用
口径卡片把指标的定义、公式、来源、粒度、时间口径、负责人与版本固定在一张卡上：查询口径、答疑与争议都以卡片为准。它要解决的是同一指标在不同报表里各有一套算法的问题，把口径从个人记忆与报表备注里挪到可检索、可评审的登记项。
基本信息
| 必填字段 | 指标编码、名称、定义、计算公式 |
|---|---|
| 溯源字段 | 数据来源表、过滤条件、责任人与审批人 |
| 口径字段 | 统计粒度、时间口径、可加性、计量单位 |
| 管理字段 | 版本号、生效日期、变更记录 |
| 消费方式 | BI 悬浮展示、指标平台检索、开发对照实现 |
典型使用场景
- 新指标上线：先建卡再开发，避免先写 SQL 再补文档
- 争议仲裁：两个部门数字不一致时以卡片定义为准逐项对齐
- 变更评审：口径调整走审批流程，卡片保留版本与生效时间
- 新人上手：从卡片理解指标含义，比读 SQL 快得多
- 对外统一：对外发布或报送监管的指标直接从卡片取定义
口径卡片示例
口径卡片示例
# 一张指标卡的最小内容
code: PAY_AMT_7D
name: 近 7 日支付金额
formula: sum(pay_amt), dt in [统计日-6, 统计日]
source: dwd.fact_pay, status = 'success'
owner: 支付域数据组
version: v3 生效 2026-09-01 变更说明: 排除退款单卡片关键字段
| 字段 | 说明 | 缺失后果 |
|---|---|---|
| 定义与公式 | 算什么、怎么算 | 两人各写一套 SQL，数字打架 |
| 来源与过滤 | 取自哪张表、排除哪些数据 | 口径无法复现，问题定位不了 |
| 粒度与时间口径 | 按什么维度与窗口统计 | 同环比与累计指标被算错 |
| 负责人与版本 | 谁维护、哪天生效 | 变更无人负责，历史口径失传 |
卡片要与实现定期核对：让指标平台按卡片生成 SQL，或跑对账任务比对卡片公式与实际结果，否则卡片很快退化为过时文档。
口径变更要走审批并通知下游：如果只改一处实现，下游看板会在同一时间点出现前后不可比的折线。