Azure DevOps部署Synapse数据库DACPAC报错：SchemaProvider无效

1. 升级DacFx/SqlPackage到支持Synapse的版本 #

• 卸载现有通过Chocolatey安装的sqlpackage和dacfx-18：

  choco uninstall sqlpackage dacfx-18 -y
  

• 安装微软官方提供的、完整支持Synapse的最新DacFx版本：

  # 下载官方DacFx安装包
  Invoke-WebRequest -Uri "https://aka.ms/dacfx-msi" -OutFile "DacFx.msi"
  # 静默安装
  Start-Process msiexec.exe -ArgumentList "/i DacFx.msi /quiet /qn /norestart" -Wait
  

• 验证版本，确保sqlpackage.exe版本在18.6及以上（该版本开始完善Synapse Serverless支持）：

  sqlpackage.exe /version
  

2. 清理版本冲突 #

Visual Studio 2022镜像自带的DacFx组件可能和手动安装版本冲突，需确保代理使用最新安装的工具：

• 将官方DacFx默认安装路径（C:\Program Files\Microsoft SQL Server\160\DAC\bin）添加到系统PATH最前端，覆盖旧版本路径：

  $newPath = "C:\Program Files\Microsoft SQL Server\160\DAC\bin;" + [Environment]::GetEnvironmentVariable("PATH", "Machine")
  [Environment]::SetEnvironmentVariable("PATH", $newPath, "Machine")
  # 刷新当前会话PATH
  $env:PATH = $newPath
  

3. 确认DACPAC的兼容性 #

• 生成DACPAC时，在Visual Studio中选择目标平台为Azure Synapse Analytics (Serverless SQL Pool)
• 若从现有Synapse数据库提取DACPAC，确保提取工具使用的是支持Synapse的DacFx版本

4. 手动测试排查环境问题 #

在VMSS实例上直接运行sqlpackage命令测试部署，排除Azure DevOps任务参数或权限问题：

sqlpackage.exe /Action:Publish /SourceFile:"YourSynapse.dacpac" /TargetConnectionString:"Server=tcp:<synapse-server-name>.sql.azuresynapse.net,1433;Initial Catalog=<db-name>;Authentication=Active Directory Integrated;"

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