用途:在 Gold 层设计阶段为事实表定义并记录粒度(grain),即存储度量值的数据明细级别,避免实现阶段对事务级与聚合级产生歧义。资料指出粒度误解占 Gold 层缺陷的 5%,但影响较大,可能需要整表重写。
主要能力:提供三种粒度模式——事务级(单代理键,每个业务事件一行)、聚合级(维度复合主键,预聚合汇总)、快照级(实体加日期,时点状态)。给出粒度类型决策树,依据主键列数与列名判断粒度类型。要求在 YAML 中显式记录 grain、grain_type 字段,并可用 PRIIMARY KEY 结构与 measures 聚合方式辅助说明。还提供合并脚本的 docstring 模板与设计阶段验证清单。
使用方式:在设计事实表 YAML 模式时,先读取 PRIMARY KEY 列并用决策树推断粒度类型,再在 YAML 中写明 grain 与 grain_type,并判断实现阶段是否需要聚合(.groupBy()/.agg())。文中给出 YAML 示例和 docstring 模板,具体代码在本整理中不展开。相关技能包括运行时粒度校验(pipeline-workers/04-grain-validation)与事实表合并模式(pipeline-workers/02-merge-patterns)。
适用场景:事实表 YAML 模式设计、transaction/aggregated/snapshot 模式选择、粒度文档编写、聚合需求判断、以及事实表设计评审。
限制:资料仅覆盖设计阶段方法,未提供具体安装命令、收费信息或平台要求;实现细节需参考关联技能文档。