在DevOps流水线中配置AgileSqlClub部署筛选器及排查加载失败问题

1. SqlAzureDacpacDeployment@1 + DeploymentAction: 'Script'能否实现仅同步指定对象？ #

原生的SqlAzureDacpacDeployment@1任务（底层依赖SqlPackage.exe）的Script动作，仅支持通过ExcludeObjectTypes参数按对象类型（比如用户、登录名）排除对象，但无法按对象名称（比如指定某张表、视图）筛选要同步的对象。所以仅靠原生配置做不到只同步指定表和视图的需求，必须借助自定义部署贡献者（比如你尝试的AgileSqlClub.DeploymentFilterContributor）。

2. 解决AgileSqlClub贡献者DLL加载失败的问题 #

针对你遇到的Required contributor with id 'AgileSqlClub.DeploymentFilterContributor' could not be loaded错误，按以下步骤排查修复：

步骤1：确认工件下载顺序与路径正确性 #

• 确保download任务在SqlAzureDacpacDeployment@1任务之前执行，否则执行Script任务时，$(Pipeline.Workspace)\drop\SqlPackageFilter目录还不存在。调整后的流水线顺序应该是：

  - download: current
    artifact: drop
    displayName: 下载包含过滤DLL的工件
  
  - task: SqlAzureDacpacDeployment@1
    name: ScriptCompare
    displayName: 生成差异脚本
    # 其余配置保持不变
  

• 检查$(Pipeline.Workspace)\drop\SqlPackageFilter目录下是否包含完整的DLL文件：
  • 必须包含AgileSqlClub.DeploymentFilterContributor.dll
  • 同时需要依赖的AgileSqlClub.SqlPackageCommon.dll（部分版本的贡献者需要这个依赖）
    可以在流水线中加一个PowerShell任务，在Script任务前打印目录内容验证：

  - powershell: |
      Get-ChildItem -Path $(Pipeline.Workspace)\drop\SqlPackageFilter
    displayName: 验证过滤DLL目录内容
  

步骤2：修正AdditionalArguments的参数格式 #

YAML中对引号的转义容易出错，建议调整AdditionalArguments的写法，用单引号包裹整个参数串，内部的双引号无需转义，避免解析错误：

AdditionalArguments: '/p:AdditionalDeploymentContributors="AgileSqlClub.DeploymentFilterContributor" /p:AdditionalDeploymentContributorPaths="$(Pipeline.Workspace)\drop\SqlPackageFilter" /p:AdditionalDeploymentContributorArguments="SqlPackageFilter0=KeepName(.*yTabl.*)" /p:ExcludeObjectTypes=Users;Logins;RoleMembership;Permissions /p:DropObjectsNotInSource=true'

（注：如果是在经典流水线中配置，直接填写参数即可，无需额外转义）

步骤3：确保DLL与SqlPackage版本兼容 #

Azure DevOps托管代理中的SqlPackage.exe版本可能会更新，要确保你使用的AgileSqlClub.DeploymentFilterContributor版本与当前代理中的SqlPackage版本匹配。可以在流水线中先执行SqlPackage /version命令查看当前版本，再下载对应版本的贡献者包。

步骤4：检查代理权限与文件访问 #

如果使用的是自托管代理，确保代理服务账号有访问$(Pipeline.Workspace)\drop\SqlPackageFilter目录的权限，且DLL文件没有被锁定或损坏。

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