在.sqlproj项目中无法使用/查询Azure Artifacts Feed含.dacpac的NuGet包

一、从Azure Artifacts Feed拉取NuGet包到本地项目 #

1. 配置项目依赖 #

在你的SDK风格.sqlproj文件中添加PackageReference，指定Dacpac NuGet包的名称和版本：

<ItemGroup>
  <!-- PrivateAssets="All" 确保包仅用于本地开发，不会被发布 -->
  <PackageReference Include="YourDacPacPackageName" Version="1.0.0" PrivateAssets="All" />
</ItemGroup>

2. 确认NuGet源配置 #

确保项目目录下的nuget.config已正确配置Azure Artifacts Feed的源和凭据（可参考以下格式校验）：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="YourAzureFeedName" value="https://pkgs.dev.azure.com/YourOrg/_packaging/YourFeed/nuget/v3/index.json" />
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  </packageSources>
  <packageSourceCredentials>
    <YourAzureFeedName>
      <add key="Username" value="你的Azure DevOps邮箱" />
      <add key="ClearTextPassword" value="你的个人访问令牌(PAT)" />
    </YourAzureFeedName>
  </packageSourceCredentials>
</configuration>

3. 还原依赖 #

执行以下命令拉取包，或在Visual Studio/VSCode中右键项目选择"还原NuGet包"：

dotnet restore
# 或使用nuget.exe
nuget restore YourProject.sqlproj

二、开发时引用Dacpac内的表 #

1. 添加数据库引用 #

在.sqlproj中添加对NuGet包内Dacpac的引用，路径基于本地NuGet缓存的内置变量：

<ItemGroup>
  <DatabaseReference Include="$(NuGetPackageRoot)/yourdacpacpackagename/1.0.0/contentFiles/any/any/test.dacpac">
    <!-- 指定目标数据库的SqlCmd变量，用于代码中引用 -->
    <DatabaseSqlCmdVariables>TargetDb=YourTargetDatabaseName</DatabaseSqlCmdVariables>
    <!-- 禁用缺失依赖错误（仅开发时可选） -->
    <SuppressMissingDependenciesErrors>True</SuppressMissingDependenciesErrors>
  </DatabaseReference>
</ItemGroup>

注意：打包NuGet时需将Dacpac放在contentFiles/any/any目录下，否则需调整上述路径。

2. 在SQL代码中引用表 #

使用SqlCmd变量+三部分名称的方式引用Dacpac内的表，SSDT工具会自动识别表结构并提供智能提示：

-- 示例：引用Dacpac中的Users表
SELECT Id, Name FROM $(TargetDb).dbo.Users;

3. 配置SqlCmd变量（可选） #

在.sqlproj中预定义开发时的SqlCmd变量值，方便本地调试：

<PropertyGroup>
  <SqlCmdVariables>TargetDb=LocalDevDatabase</SqlCmdVariables>
</PropertyGroup>

环境适配建议 #

• 升级到VS2022+.NET6.0：SDK风格的SQL项目在该环境下支持更完善，SSDT工具的智能提示和依赖管理更稳定。
• 安装SQL Server Data Tools(SSDT)：确保VS/VSCode中已安装SSDT扩展，才能识别Dacpac并提供SQL智能提示。

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