使用自托管DevOps代理时，SQL预部署脚本引用文件失败求助

问题根源 #

SqlAzureDacpacDeployment@1任务执行时，默认工作目录并非主预部署脚本所在目录，而是自托管代理的根工作目录（通常为_work文件夹）。这导致你用.\或相对路径引用同目录脚本时，SQLCMD会在代理根目录下查找，而非脚本实际所在的01_preDeployment目录，自然找不到目标文件。

解决方案 #

1. 显式设置任务工作目录 #

在SqlAzureDacpacDeployment@1任务中添加WorkingDirectory参数，指定为主脚本所在目录，让SQLCMD以此为基准查找引用文件：

- task: SqlAzureDacpacDeployment@1
  displayName: 2. Execute PreDeployment Script
  inputs:
    azureSubscription: '${{ parameters.ServiceConnectionPrefix}}${{ parameters.env }}'
    AuthenticationType: 'servicePrincipal'
    ServerName: '$(ServerName)'
    DatabaseName: '${{ parameters.SQLDatabaseName }}'
    deployType: 'SqlTask'
    SqlFile: '$(Pipeline.Workspace)/${{ parameters.SQLProjectName }}/${{ parameters.SQLProjectName }}/01_preDeployment/Script.PreDeployment_t10-asqldb-mdw.sql'
    # 指定工作目录为主脚本所在目录
    WorkingDirectory: '$(Pipeline.Workspace)/${{ parameters.SQLProjectName }}/${{ parameters.SQLProjectName }}/01_preDeployment/'

2. 使用绝对路径引用脚本 #

修改主预部署脚本中的:r命令，用流水线变量拼接被引用脚本的绝对路径，确保SQLCMD能准确定位：

PRINT N'Execute PreDeployKeysAndSystemUsers.sql'
:r '$(Pipeline.Workspace)/${{ parameters.SQLProjectName }}/${{ parameters.SQLProjectName }}/01_preDeployment/PreDeployKeysAndSystemUsers.sql'

PRINT N'Execute PreDeployUsersAndRoles.sql'
:r '$(Pipeline.Workspace)/${{ parameters.SQLProjectName }}/${{ parameters.SQLProjectName }}/01_preDeployment/PreDeployUsersAndRoles.sql'

PRINT N'Execute PreDeployDDLStatements.sql'
:r '$(Pipeline.Workspace)/${{ parameters.SQLProjectName }}/${{ parameters.SQLProjectName }}/01_preDeployment/PreDeployDDLStatements.sql'

3. 路径验证（可选） #

若仍不确定路径问题，可在预部署任务前添加PowerShell任务，输出目录信息辅助排查：

- task: PowerShell@2
  displayName: Validate deployment paths
  inputs:
    targetType: 'inline'
    script: |
      $scriptPath = '$(Pipeline.Workspace)/${{ parameters.SQLProjectName }}/${{ parameters.SQLProjectName }}/01_preDeployment/Script.PreDeployment_t10-asqldb-mdw.sql'
      Write-Host "Agent current working directory: $(Get-Location)"
      Write-Host "Pre-deployment script directory: $(Split-Path $scriptPath -Parent)"
      Write-Host "Files in script directory:"
      Get-ChildItem $(Split-Path $scriptPath -Parent)

关键说明 #

数据库项目默认仅支持单个预部署脚本，通过SQLCMD的:r命令拆分任务是合理方案，但必须确保SQLCMD工作目录与脚本目录一致，或使用绝对路径定位，才能避免路径错误。

内容的提问来源于stack exchange，提问作者Koen van Wielink