SQL 片段很容易变成一堆临时语句。真正可复用的 SQL 资料，需要写清用途、影响范围和验证方式。
先区分 SQL 类型
常见 SQL 可以分为：
- 查询 SQL。
- 统计 SQL。
- 修复 SQL。
- DDL 变更。
- 数据回填。
- 数据清理。
- 排障 SQL。
查询和统计风险较低，修复、回填、清理和 DDL 风险更高。
每段 SQL 要写用途
SQL 片段前最好写：
- 解决什么问题。
- 适用哪张表。
- 是否只读。
- 影响多少数据。
- 如何验证。
没有说明的 SQL，以后很难判断能不能再用。
写操作必须有审计意识
涉及 UPDATE、DELETE、INSERT、DDL 的 SQL，要先 dry-run 或查询影响范围。
执行前确认：
- 目标库。
- 目标表。
- where 条件。
- 影响行数。
- 备份或回滚方式。
- 执行后校验 SQL。
不要把临时修复 SQL 当成普通笔记随手执行。
DDL 要写字段语义
建表或加字段时，要写清：
- 字段用途。
- 单位。
- 时区。
- 是否可空。
- 默认值。
- 索引目的。
- 表和字段注释。
这能减少后续维护成本。
维护建议
SQL 片段可以按“只读查询、数据修复、DDL、排障”分类保存。
每段 SQL 都要有用途和验证说明，才能从临时命令变成可靠资产。
正文完
