如何使用Liquibase捕获SQL Server指定架构的存储过程与函数？

Got it, let's walk through how to capture stored procedures and functions from a specific schema in SQL Server using Liquibase. I’ve done this a few times, so here’s the reliable breakdown:

1. 先搞定Liquibase配置文件 #

首先，你需要一个liquibase.properties配置文件来连接你的SQL Server数据库。示例配置如下，记得替换成你自己的数据库信息：

driver: com.microsoft.sqlserver.jdbc.SQLServerDriver
classpath: sqljdbc42.jar  # 换成你的SQL Server JDBC驱动路径，版本要和数据库匹配
url: jdbc:sqlserver://your-server-name:1433;databaseName=your-db-name;encrypt=false
username: your-db-username
password: your-db-password
changeLogFile: dbchangelog.xml  # 生成的变更日志会存在这个文件里

2. 用generateChangeLog命令精准捕获目标对象 #

Liquibase的generateChangeLog命令支持过滤特定架构和对象类型，这正是我们需要的。

捕获指定架构下的所有存储过程 #

在命令行执行这条命令，把your-schema替换成你要捕获的架构名称：

liquibase generateChangeLog --includeObjects="procedure:your-schema.*" --schemaName=your-schema

捕获指定架构下的所有函数 #

同理，针对函数的命令：

liquibase generateChangeLog --includeObjects="function:your-schema.*" --schemaName=your-schema

一次捕获存储过程和函数 #

如果想一次性搞定两种对象，用逗号分隔类型即可：

liquibase generateChangeLog --includeObjects="procedure:your-schema.*,function:your-schema.*" --schemaName=your-schema

参数说明

• --includeObjects：指定要包含的对象类型和匹配规则，*是通配符，代表该架构下所有对应类型的对象
• --schemaName：限定只处理这个架构下的对象，避免误捕获其他架构的内容

3. 检查并调整生成的变更日志 #

执行完命令后，Liquibase会生成你指定的dbchangelog.xml文件。打开它看看：

• 每个存储过程对应一个<createProcedure>标签，函数对应<createFunction>标签
• 每个变更集都有id、author等属性，你可以根据需要修改这些信息，或者拆分变更集让结构更清晰

4. 验证捕获的内容是否正确 #

为了确保捕获的定义没问题，你可以用updateSQL命令预览要执行的SQL语句，确认和原对象一致：

liquibase updateSQL

如果没问题，也可以用update命令把这些变更应用到测试数据库，对比原对象和生成的对象是否完全一致：

liquibase update

一些小提醒 #

• 尽量用最新版本的Liquibase，旧版本对SQL Server的存储过程/函数支持可能有局限
• JDBC驱动要和你的SQL Server版本兼容，不然可能出现连接失败或者捕获不完整的情况
• 如果你的存储过程/函数是加密的，Liquibase可能无法捕获完整定义，这种情况需要手动补充到变更日志里

内容的提问来源于stack exchange，提问作者shalabh