SqlAzureDacpacDeployment@1任务参数配置报错，寻求解决方案

我在Azure DevOps流水线中配置了SqlAzureDacpacDeployment@1任务，用于执行SQL脚本添加Azure AD包含用户，任务配置如下：

- task: SqlAzureDacpacDeployment@1
  inputs:
    azureSubscription: 'azureappsharedresources-tfssc-nonprod-dev-001'
    ServerName: $(sqlServerName).database.windows.net
    DatabaseName: 'sqldb-sms-router-dev-001'
    AuthenticationType: 'aadAuthenticationIntegrated'
    deployType: SqlTask
    SqlFile: './deploy/azure-pipelines/addContainedUsers.sql'
    SqlAdditionalArguments: '-UserName func-sms-router-dev-001 -DatabaseName sqldb-sms-router-dev-001'

对应的SQL脚本addContainedUsers.sql内容：

:setvar UserName "func-sms-router-dev-001"
:setvar DatabaseName "sqldb-sms-router-dev-001"

USE [$(DatabaseName)];
GO
CREATE USER [$(UserName)] FROM EXTERNAL PROVIDER;
GO
EXEC sp_addrolemember 'db_datareader', '$(UserName)';
EXEC sp_addrolemember 'db_datawriter', '$(UserName)';
GO

尝试过按照建议使用/v:格式传递变量：

SqlAdditionalArguments: '/v:UserName=func-sms-router-dev-001 /v:DatabaseName=sqldb-sms-router-dev-001'

但两种方式都触发错误：

##[error]Parameter set cannot be resolved using the specified named parameters.

排查方向与解决方案 #

• 避免参数冲突
  任务本身已通过DatabaseName输入项指定目标数据库，在SqlAdditionalArguments中重复传递同名变量会导致参数集冲突。修改任务配置，只传递UserName变量：

  SqlAdditionalArguments: '/v:UserName=func-sms-router-dev-001'
  

  同时调整SQL脚本，移除DatabaseName的:setvar定义，依赖任务指定的上下文数据库执行：

  :setvar UserName "func-sms-router-dev-001"
  
  CREATE USER [$(UserName)] FROM EXTERNAL PROVIDER;
  GO
  EXEC sp_addrolemember 'db_datareader', '$(UserName)';
  EXEC sp_addrolemember 'db_datawriter', '$(UserName)';
  GO
  

• 遵循sqlcmd参数格式
  任务底层调用sqlcmd执行脚本，必须使用/v:前缀传递脚本变量，确保变量名与SQL脚本中:setvar的定义完全匹配，避免使用与任务内置输入项重名的变量。

• 验证权限配置
  使用aadAuthenticationIntegrated身份验证时，确保流水线执行身份（托管标识或服务主体）拥有目标数据库的db_owner权限，或至少具备创建用户、添加角色成员的权限，权限不足可能引发异常表现。

• 检查任务与环境版本
  升级SqlAzureDacpacDeployment任务至最新补丁版本，同时确认代理环境中的sqlcmd版本与任务兼容。

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