sql报表多版本统计与版本控制通过版本号、元数据表及路由机制实现可追溯、可回滚、并行运行；上线新版本不覆盖旧版，以is_default标记主用版本；支持按日期、环境、参数路由；口径变更需新建版本并注释弃用；跨版本聚合采用“版本快照+时间对齐”；上线前须经语法权限、结果一致性、灰度验证三重校验。
SQL报表的多版本统计和版本控制，核心在于让不同时间点、不同业务需求下的报表逻辑可追溯、可回滚、可并行运行，同时不影响线上数据一致性与查询稳定性。
版本标识与元数据管理
每个报表SQL需绑定唯一版本号（如v1.2.0）及生效时间戳，并记录在独立的元数据表中。该表至少包含字段：报表ID、SQL内容、版本号、创建人、审核状态、上线时间、是否默认版本。上线新版本时，不覆盖旧SQL，而是插入新记录，并通过is_default = 1标记当前主用版本。
运行时版本路由机制
报表服务层需支持按请求上下文自动选择SQL版本。常见策略包括：
- 按日期路由：如“统计2024年Q1数据”强制使用v1.1.5（该版本当时已上线且逻辑稳定）
- 按环境隔离：开发环境调用v2.0.0-dev，生产环境只认v1.3.0及以上已审核版本
- 按参数显式指定：
?version=v1.2.0用于对比验证或历史回溯
统计口径变更的兼容处理
当指标定义调整（如“活跃用户”从“当日登录”改为“7日内登录且有行为”），不能直接修改原SQL，而应：
- 新建版本，更新SQL与文档说明变更原因及影响范围
- 在旧版本SQL中保留注释标注废弃提示，例如：
-- ⚠️ 已弃用：此版本按旧口径计算，仅用于历史对比 - 对跨版本聚合类报表（如月度累计），统一采用“版本快照+时间对齐”方式：先按各时段对应版本分别计算，再合并结果，避免口径混用
自动化校验与灰度发布
上线前必须通过三重校验：
- 语法与权限校验：检查SQL是否可通过解析器，目标表/字段是否存在，执行账号是否有读权限
- 结果一致性比对：对相同样本数据，新旧版本输出关键字段（如sum、count、去重数）偏差超过阈值则阻断上线
- 灰度流量验证：将5%真实查询路由至新版本，监控错误率、耗时、结果分布，达标后再全量切换
