如何管理SQL存储过程版本控制：利用脚本文件与Git工具

SQL存储过程怎么放进Git，又不被数据库拒绝？

把.sql文件直接提交到Git仓库，技术上当然没问题。但真正的拦路虎往往在后面：当你修改了存储过程，信心满满地再次执行脚本时，数据库却毫不留情地抛出一个错误——“数据库中已存在名为‘xxx’的对象”。这其实不是Git的错，问题出在SQL脚本的写法没有跟上版本控制的思路。

关键在于，脚本必须具备“幂等性”，也就是无论执行多少次，结果都应该一致。实现这一点，核心做法是统一采用IF EXISTS ... DROP + CREATE的组合拳，而不是直接裸写一个CREATE PROCEDURE。这样一来，无论是在CI/CD流水线中，还是在本地重建数据库时，脚本都能顺畅运行，不会中途“罢工”。

• 别再写CREATE PROCEDURE usp_get_user了——第二次执行它就会报错。
• 应该改写成这样：

  IF OBJECT_ID('usp_get_user', 'P') IS NOT NULL
      DROP PROCEDURE usp_get_user;
  GO
  CREATE PROCEDURE usp_get_user ...

• 这里的GO是批处理分隔符，绝对不能省略。否则，DROP和CREATE会被当作同一批语句解析，SQL Server会直接报语法错误。
• PostgreSQL用户请注意：虽然它原生支持DROP FUNCTION IF EXISTS，省去了手动判断的步骤，但必须完整指定函数名和参数类型，例如my_func(integer)，一个都不能少。

Git 提交时该提交哪些文件？只放 .sql 行不行？

只提交.sql文件，从版本管理的角度看是足够的。但这背后需要两个强有力的约束来支撑：明确的文件命名规则和反映依赖关系的目录结构。

否则，团队协作很容易陷入混乱。想象一下，有人先执行了依赖新表的存储过程脚本，而后执行建表脚本，编译失败几乎是必然的。更头疼的是，事后排查到底是谁先动了“上游”逻辑，会非常困难。

• 文件名必须包含序号和描述。例如：001_create_users_table.sql、002_add_usp_get_user.sql。序号决定了执行顺序。
• 执行顺序通常按文件名字母序排列（而非提交时间）。因此，必须确保002号脚本所依赖的表，在001号脚本中已经创建完毕。
• 不要把针对不同环境的特殊修改混在一个文件里。比如，像ALTER PROCEDURE ... SET ANSI_NULLS ON这类设置变更，应该单独拆分成003_fix_ansi_nulls.sql。这样做，回滚时才清晰明了。
• 如果使用Flyway或Liquibase这类专业数据库迁移工具，它们会自动跟踪已执行的脚本。但在纯Git管理模式下，执行顺序完全依赖人工维护，这里恰恰是最容易出错的地方。

ALTER PROCEDURE 能不能直接提交到 Git？

能提交，但不推荐作为主要的变更管理方式。原因在于，ALTER PROCEDURE是一种“就地更新”，在Git的版本历史里，你很难一眼看出这次变更的本质：它是在修复一个紧急Bug？增加了一个新的查询字段？还是调整了权限？历史追溯的成本会变得很高。

更稳妥的做法是，将每一次变更都转化为一次“重建”。也就是为新版存储过程编写全新的DROP + CREATE脚本，并通过清晰的注释标明变更点。

• 错误示范：ALTER PROCEDURE usp_get_user AS SELECT * FROM users WHERE id = @id。Git的差异对比可能只显示这一行改动，但你看不到这个存储过程之前可能连@id这个参数都没有。
• 正确做法：将新脚本命名为004_update_usp_get_user_v2.sql，在文件开头用注释说明，例如-- [v2] 新增 @include_deleted 参数以支持查询已删除用户，然后完整地写出新的存储过程逻辑。
• 还有一个技术细节需要注意：在SQL Server中，使用ALTER不会改变对象的原始创建时间（create_date字段保持不变），而DROP+CREATE会刷新这个时间戳。如果你的某些运维脚本依赖这个元数据，就需要提前对齐策略。

开发机和测试库结构不一致，脚本一跑就挂怎么办？

这通常不是脚本本身的质量问题，而是环境基线失去了控制。Git管理的是我们的“变更意图”，而不是最终的“执行结果”。同一份.sql脚本，在一个缺少某张表、某个用户或某个架构的数据库里，失败是必然的。

因此，必须为每一个环境（开发、测试、生产）建立一个明确的、可复现的初始化起点，并且这个起点本身也应该被Git所追踪。

• 在项目根目录下建立一个baseline/文件夹，里面存放create_database.sql和create_schema.sql>等基础建库建表脚本。所有后续的变更分支，都应基于这个基线进行演进。
• 尽量避免在脚本中硬编码USE mydb这样的语句。它会将脚本强绑定到特定的数据库名上，当CI/CD流程需要在另一个名字的测试库上运行时，脚本就会失效。更好的做法是通过连接字符串来指定目标数据库。
• 将权限管理语句（例如GRANT EXECUTE ON usp_get_user TO app_user）单独抽取出来，放在permissions/这样的独立目录中。这样，不同的环境可以根据需要选择性地执行权限脚本。
• 最后，有一个最常被忽略的细节：像SQL Server中的QUOTED_IDENTIFIER设置，或者PostgreSQL中的search_path设置。如果在脚本中没有显式声明，同一个脚本在SSMS图形界面和sqlcmd命令行工具下执行，可能会产生不同的结果，导致“在我的机器上好好的”这类问题。