如何为SSDT(.sqlproj)添加基于SQL的完整性检查？

在SSDT的PostDeploy脚本中，SQLCMD模式默认不会因普通错误终止执行，且PRINT输出可能因缓冲无法即时显示。可通过以下方式解决：

• 启用SQLCMD错误终止指令：在脚本开头添加:on error exit，让SQLCMD遇到错误时立即终止后续执行。
• 使用即时输出的错误提示：结合SET XACT_ABORT ON确保事务出错时回滚，并用RAISERROR（兼容旧版SQL Server）或THROW抛出带即时输出的错误，避免信息被缓冲。

示例脚本：

:on error exit
SET XACT_ABORT ON;
SET NOCOUNT ON;

-- 对比触发器定义逻辑
DECLARE @ExpectedDefinition NVARCHAR(MAX) = N'INSERT YOUR EXPECTED TRIGGER DEFINITION HERE';
DECLARE @ActualDefinition NVARCHAR(MAX) = (
    SELECT definition FROM sys.triggers t
    JOIN sys.sql_modules m ON t.object_id = m.object_id
    WHERE t.name = N'YourTriggerName'
);

IF @ActualDefinition != @ExpectedDefinition
BEGIN
    RAISERROR(N'触发器定义不匹配！请重新运行自动生成触发器的脚本。预期定义：%s，实际定义：%s', 16, 1, @ExpectedDefinition, @ActualDefinition) WITH NOWAIT;
    THROW; -- 抛出终止级错误
END

说明：RAISERROR的严重级别设为16（可终止执行的错误级别），WITH NOWAIT确保错误信息即时发送到客户端，避免输出被缓冲。

推荐在SSDT构建阶段完成校验，直接针对项目输出的dacpac文件（包含完整架构对象定义）做检查，无需连接真实数据库，具体实现方式如下：

方式1：自定义MSBuild任务校验dacpac #

1. 提取dacpac架构内容：用SSDT自带的SQLPackage.exe将dacpac提取为SQL脚本。
2. 添加构建后事件：在项目属性→生成事件→生成后事件中，调用命令行脚本执行对比逻辑。

示例构建后事件命令：

:: 提取dacpac到临时SQL文件
"$(SQLPackagePath)\SQLPackage.exe" /Action:Extract /SourceFile:"$(TargetPath)" /TargetFile:"$(ProjectDir)Temp\ExtractedSchema.sql" /OverwriteFiles:True

:: 调用PowerShell脚本对比触发器定义
PowerShell -ExecutionPolicy Bypass -File "$(ProjectDir)\CheckTriggerDefinition.ps1" -ExpectedTriggerPath "$(ProjectDir)\ExpectedTrigger.sql" -ExtractedSchemaPath "$(ProjectDir)Temp\ExtractedSchema.sql"

对应的PowerShell脚本可读取预期触发器文件与提取的架构文件，对比内容后不匹配则抛出错误，MSBuild会捕获错误并终止构建。

方式2：自定义SSDT静态代码分析规则 #

1. 编写自定义分析规则：基于SSDT的静态代码分析框架（Roslyn），编写规则扫描项目中的触发器对象，检查其定义是否与预期模板一致。
2. 集成到构建流程：将规则打包为VSIX插件，添加到SSDT项目中，构建时自动触发检查，不符合则直接报错。
   这种方式更贴合SSDT原生工作流，无需额外脚本，适合长期维护的项目。

关于SSDT单元测试 #

SSDT单元测试必须依赖测试数据库，需先部署架构才能执行，不符合“无需依赖现有数据库”的需求，因此不推荐。

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