批量报表的流程结构
批量报表是按周期对大量对象生成同类文档，例如月度资源用量、巡检周报、审计月报。可靠实现的关键是把流水线切成四段：取数、计算、渲染、分发。分段的价值在于失败可定位、可局部重跑——模板改错只需重渲染，数据源补数只需重取数，而不必整批重来。每一步都要有稳定的幂等键，否则补跑会产生重复或相互矛盾的结果。
基本信息
| 流水线四段 | 数据抽取、指标计算、模板渲染、分发归档 |
|---|---|
| 触发方式 | 定时调度、事件触发、人工按周期补跑 |
| 幂等键 | 报表编码加统计周期加对象标识 |
| 性能手段 | 按分区并行、取数限流、渲染池化 |
| 留痕要求 | 保留取数结果与口径版本，便于事后复核 |
典型使用场景
- 周期性运营报表：按自然月生成资源用量与成本结果并分发
- 巡检与合规报表：汇总检查项结果，形成可归档的周期报告
- 多租户分发：同一模板按租户切分，各自只收到本租户数据
- 历史补跑：数据源延迟到达后按周期重跑，覆盖原先不完整的结果
- 口径调整：指标定义变更后，对受影响周期批量重算并标注口径版本
各段产出与失败处理
| 环节 | 产出 | 失败处理 |
|---|---|---|
| 取数 | 按口径抽取的明细或预聚合结果 | 数据源不可用时有限次重试，并标记缺失区间 |
| 计算 | 指标结果集 | 口径变更需版本化，避免同周期结果前后不一致 |
| 渲染 | 成品文件 | 模板错误只重渲染，不重跑取数 |
| 分发 | 投递记录与归档路径 | 部分失败只重发失败对象，不整批重发 |
| 复核 | 与上期差异摘要 | 突变需人工确认后再对外发布 |
流水线定义片段
流水线定义片段
report_id: res-usage-monthly # 报表编码，与周期共同构成幂等键
period: 2026-09 # 统计周期，时区与自然月边界需在口径中写明
stages:
- extract: 按周期与租户取数并落地原始结果 # 原始结果留存，便于复核与重算
- compute: 按口径版本计算指标
- render: 套用模板生成文件
- deliver: 按订阅关系投递并记录回执
rerun: 覆盖同幂等键结果，不产生第二份 # 避免同一周期出现两个版本
missing_data: 标注缺失区间并在报表页脚说明 # 静默出空值比报错更危险同一报表、同一周期重复运行必须得到相同结果，或明确覆盖前一版并保留版本号。让两个版本同时在外流通，会让所有下游讨论都失去基准。
数据边界要在口径里写死：自然月与滚动 30 天、UTC 与本地时区、补齐策略都会改变数字。这类差异造成的争议往往比取数失败更浪费时间。