珠江实业 T-SQL 脚本开发

快速开始

当你需要为“珠江实业客户”编写/改造 SQL Server (T‑SQL) 脚本时：

• •先按“决策树”确定脚本类型
• •从 references/templates.md 复制对应模板并替换占位符
• •交付/上线前用 references/checklists.md 自检

工作流决策树（先分型再写）

• •报表/查询脚本：以 SELECT 为主，允许临时表 # 拆解，常见“实时/快照版本号”双口径
• •存储过程/作业脚本：CREATE/ALTER PROCEDURE，分段 TRY...CATCH，写执行日志表，失败 THROW
• •数据治理/修复脚本：先备份/对账，再修复；强调可回滚、影响行数可解释、避免长事务阻塞

通用约定（所有类型都遵守）

• •脚本头部注释（必须）：目的、影响对象（库/表/存储过程）、执行环境、是否可重复执行、回滚方案
• •参数化优先：@BUGUID / @ProjGUID / @版本号 / @StartDate/@EndDate 等作为输入，避免硬编码
• •口径与单位明确：金额是否 /10000.0、日期口径（SkDate vs CWSkDate）、关键业务字段取值逻辑要写明
• •可验证：关键更新/插入后输出或记录 @@ROWCOUNT；治理脚本必须提供 before/after 对账
• •一致的 T‑SQL 风格：
  • •存储过程：SET NOCOUNT ON;
  • •临时表：创建前先 drop，结束后清理
  • •WITH(NOLOCK) 仅在容忍不一致的报表场景使用，并在注释说明风险
• •先查表结构再写 SQL（推荐）：当涉及“表结构/字段含义/字段口径/主键/关联关系/枚举值”等问题时，优先读取对应系统的数据字典设计文档，再落到脚本实现，避免凭经验猜字段。

仓库内代表脚本可用于对照风格：

• •销售系统/报表拍照存储过程SP_SnapshotReport.sql
• •销售系统/01考核汇总表.sql
• •计划系统/修改计划节点信息.sql

报表/查询脚本开发指南

• •推荐形态：确有需要时做“实时/快照版本号”双口径：实时从 data_wide_* 宽表计算，快照从 Result_*/*_snapshot 表读取
• •性能：
  • •过滤条件尽量落在可索引字段上（日期、GUID、状态），避免在列上套函数
  • •复杂口径用 #临时表 分段汇总，避免超长单条 SQL 难维护
• •一致性：字段顺序、中文别名与下游报表保持一致

存储过程/作业（快照类）开发指南

• •骨架：USE ...; GO + ANSI_NULLS/QUOTED_IDENTIFIER + ALTER PROCEDURE + SET NOCOUNT ON;
• •日志与分段：每个子任务独立 TRY...CATCH，Started/Completed/Failed 都要写；失败记录 ERROR_MESSAGE() 并 THROW
• •临时表：创建前 drop；结束后清理

数据治理/修复脚本开发指南

• •执行策略（强制）：备份 → 修复前对账 → 修复 → 修复后对账 → 回滚方案
• •事务策略：小范围可单事务；大范围优先分批（batch）降低锁表与阻塞风险
• •交付物：同一份 .sql 内包含变更说明、对账查询、修复语句、回滚语句/指引

示例触发语句（用于自测）

• •报表：写一个报表 SQL，支持 @版本号=实时/快照，按项目过滤且输出字段口径一致。
• •快照作业：把 XX 报表做成快照存储过程：分段 TRY...CATCH，写 SnapshotExecutionLog，失败 THROW。
• •修复治理：写一个数据治理修复脚本：先备份表，再修复字段值，给出 before/after 对账与回滚。

本 Skill 的参考文件

• •references/templates.md：三类脚本可复制模板
• •references/checklists.md：交付/上线前检查清单
• •references/采招系统-数据字典文档_设计文档.md：采招系统表结构与字段口径
• •references/成本系统-数据字典文档_设计文档.md：成本系统表结构与字段口径
• •references/销售系统-数据字典文档_设计文档.md：销售系统表结构与字段口径

数据字典触发场景（遇到这些就先读字典）

• •“某张表有哪些字段/字段含义是什么/字段是否可空/默认值/枚举值”
• •“主键是什么/与哪张表关联/如何 join 才不重复”
• •“某指标口径字段来自哪里/宽表 data_wide_* 对应明细表是什么”