Visual Studio SSDT数据库项目：添加引用时不继承SQLCMD变量

一、变量继承的设计逻辑 #

SSDT的数据库引用机制核心是保证跨项目对象引用的编译完整性。当添加数据库引用时，被引用项目的整个模型（包括SQLCMD变量）会合并到引用项目的编译上下文——这是因为被引用项目的对象可能依赖自身的变量（比如库名、文件路径等），编译引用项目时需要这些变量来解析跨库对象的语法正确性，避免出现未定义变量的编译错误。这种“全量继承”是默认设计，确保编译阶段的校验覆盖所有依赖场景。

二、排除无关继承变量的解决方案 #

针对继承变量对当前项目发布无影响的场景，可通过以下方式处理：

1. 配置数据库引用的变量替代 #

在Visual Studio中操作引用项目的数据库引用属性：

• 右键引用项目 → 选择“引用” → 找到对应数据库引用 → 右键“属性”
• 在“变量”标签页中，对被引用项目的无关变量（如示例中的A、B）设置固定默认值（比如空字符串或任意占位值）
• 保存后，发布时这些变量会使用预设值，不再弹出输入提示

2. 手动编辑发布配置文件 #

打开项目的*.publishprofile.xml文件，找到<SqlCommandVariables>节点：

• 保留当前项目需要的变量（如示例中的C、D），同时为继承的无关变量添加固定值配置，示例代码：

<SqlCommandVariables>
  <SqlCommandVariable Include="C" Value=""/>
  <SqlCommandVariable Include="D" Value=""/>
  <SqlCommandVariable Include="A" Value=""/>
  <SqlCommandVariable Include="B" Value=""/>
</SqlCommandVariables>

发布时会直接使用预设值，不会要求输入无关变量。

3. 修改项目文件（.sqlproj） #

若需要批量或自动化配置，可编辑引用项目的.sqlproj文件：

• 找到对应数据库引用的<DatabaseReference>节点，添加变量固定值配置，示例代码：

<DatabaseReference Include="..\ProjectOne\ProjectOne.sqlproj">
  <HintPath>..\ProjectOne\bin\Debug\ProjectOne.dacpac</HintPath>
  <SuppressMissingDependenciesErrors>False</SuppressMissingDependenciesErrors>
  <SqlCommandVariables>
    <Variable Name="A" Value=""/>
    <Variable Name="B" Value=""/>
  </SqlCommandVariables>
</DatabaseReference>

这种方式会在编译阶段就固定被引用变量的值，发布时自然不会再提示输入。

注意事项 #

如果被引用项目的对象实际依赖自身的SQLCMD变量（比如跨库引用中用到了被引用库的变量名），则不能直接排除这些变量，否则会导致编译错误。只有确认继承变量对当前项目的编译、部署完全无影响时，才适合使用上述方案。

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