指标口径定义：原子指标、派生指标、计算逻辑、时点/时段口径的规范模板

指标口径是整个度量体系的“语言标准”。口径不一致，数据就会“对不上”。本章聚焦四个核心概念：原子指标、派生指标、计算逻辑以及时点/时段口径，并给出可直接复用的规范模板。

1. 原子指标 vs 派生指标

2. 计算逻辑规范

计算逻辑必须明确：对原子指标使用何种聚合函数（SUM、AVG、COUNT、MAX、MIN），以及是否涉及去重、条件过滤、加权等。

• 简单派生：原子指标直接聚合 → SUM(pay_amount)
• 条件派生：增加 WHERE 子句 → SUM(pay_amount) WHERE gender = 'male'
• 比率派生：两个派生指标相除 → d7_male_pay_amount / d7_all_pay_amount
• 时间偏移派生：与历史同期比较 → 当前值 / 去年同期值 - 1

-- 示例：近7日男性用户支付金额
SELECT product_category,
       SUM(pay_amount) AS d7_male_pay_amount
FROM order_fact
WHERE gender = 'male'
  AND pay_date BETWEEN CURRENT_DATE - INTERVAL '7 DAY' AND CURRENT_DATE - INTERVAL '1 DAY'
GROUP BY product_category;

3. 时点口径 vs 时段口径

4. 口径定义规范模板（完整填写示例）

指标名称：近7日男性用户支付金额
指标编码：D7_MALE_PAY_AMOUNT
所属主题域：交易域
原子指标引用：pay_amount (order_fact)
派生逻辑：按product_category分组，对pay_amount求和
时间口径：时段（近7天，不含当日）
维度限定：gender = 'male'
计算函数：SUM
更新频率：每日凌晨计算
数据源表：ods.order_fact

5. 指标口径层级关系图（原子→派生→计算→时点/时段）

6. 实战要点与避坑

• 原子指标只增不改：一旦发布，禁止修改业务含义；如需调整，申请新版本并废弃旧版本。
• 派生指标必须登记父指标编码：便于血缘追溯。
• 时点口径要求准确快照：通常使用拉链表或 T+1 全量快照，不要用时序聚合替代。
• 时段口径必须明确窗口定义：“近7日”是指包含当日还是近7个自然日？是否跨月？需统一到业务日历。
• 每个派生指标只能有唯一计算逻辑：不允许同一个指标名称在两张表中用不同聚合方式。