使用DACPAC部署SQL Server后未创建外键的原因排查

问题描述 #

我遇到一个异常问题：有如下SQL表定义：

CREATE TABLE [dbo].[ParameterValue]
(
    [ParameterValueID] INT NOT NULL IDENTITY(1, 1), 
    [ParameterID] INT NULL, 
    [FieldDefinitionID] INT NULL, 
    [ParameterValue] VARCHAR(2000) NULL, 
    [ParameterValueTypeID] SMALLINT NOT NULL DEFAULT 0,
)
GO
-- Constraints and Indexes
ALTER TABLE [dbo].[ParameterValue] ADD CONSTRAINT [Pk_ParameterValue_ParameterValueID] PRIMARY KEY CLUSTERED  ([ParameterValueID])
GO

ALTER TABLE [dbo].[ParameterValue] ADD CONSTRAINT [FK_ParameterValue_Parameter] FOREIGN KEY ([ParameterID]) REFERENCES [Parameter]([ParameterID])
GO

ALTER TABLE [dbo].[ParameterValue] ADD CONSTRAINT [FK_ParameterValue_FieldDefinition] FOREIGN KEY ([FieldDefinitionID]) REFERENCES [FieldDefinition]([FieldDefinitionID])
GO

通过DACPAC部署后生成的表仅添加了主键约束，外键约束完全缺失，最终创建的表没有外键。使用的SQL Server版本为13.0.5103.6。

可能的原因 #

• 引用目标表未包含在DACPAC项目中：DACPAC依赖项目内的对象元数据进行部署，如果Parameter和FieldDefinition这两个表没有被添加到当前DACPAC项目里，部署时会因无法找到引用对象而自动跳过外键创建（默认部署规则不会抛出此类错误）。
• 部署配置禁用了外键处理：检查DACPAC的部署选项，若开启了IgnoreForeignKeys、DropUnusedObjects或类似参数，会导致部署过程中忽略外键约束的创建或保留。
• 对象引用存在隐性不匹配：比如目标数据库中Parameter或FieldDefinition的主键列类型与外键列（ParameterID/FieldDefinitionID）不匹配，或者引用表的架构（如dbo）未明确指定导致环境解析错误，都会让DACPAC跳过外键创建。
• 工具版本兼容性问题：SQL Server 13.0对应2016版本，若生成DACPAC的SSDT（SQL Server Data Tools）版本与数据库版本不兼容，可能出现对象定义解析错误，遗漏外键约束。

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