Azure DevOps中单SQL脚本持续部署：管道配置与路径问题

一、构建管道配置SQL脚本 #

• 将SQL脚本存入Azure Repos仓库，可放在代码库内单独的SQL目录下，比如/sql/scripts/test.sql
• 推荐使用SQL Server Database Deployment任务（专门针对SQL部署场景）：
  1. 添加任务后，在「SQL script」字段填写仓库内的相对路径，示例：$(Build.SourcesDirectory)/sql/scripts/test.sql
  2. 配置目标数据库的连接信息，包括服务器名、数据库名、认证方式
• 若需要将脚本作为构建产物传递给发布阶段，添加Publish Build Artifacts任务：
  • 指定「Path to publish」为脚本所在目录，比如$(Build.SourcesDirectory)/sql/scripts
  • 设置「Artifact name」为SQLScripts（自定义名称，方便发布阶段识别）

二、发布管道配置SQL脚本 #

• 先添加Download Build Artifacts任务，选择构建阶段发布的SQLScripts工件，默认会下载到$(System.ArtifactsDirectory)/SQLScripts目录
• 再次使用SQL Server Database Deployment任务，指定脚本路径为$(System.ArtifactsDirectory)/SQLScripts/test.sql
• 配置目标数据库的连接参数，确保执行账号拥有脚本所需的数据库权限（如DDL/DML执行权限）

三、路径问题解决 #

你输入C:\test\test.sql提示无效，核心原因是Azure DevOps管道运行环境（托管/自托管代理）中不存在该本地绝对路径：

• 托管代理：运行在微软托管的虚拟机上，本地固定路径C:\test不存在，必须使用管道预定义变量或仓库相对路径
• 自托管代理：即使是自建代理，也不建议用固定本地路径，应将脚本存入代码仓库，使用相对路径或代理工作目录变量，比如$(Agent.WorkFolder)/_work/1/s/sql/scripts/test.sql
• 正确路径规范：
  • 构建阶段：用$(Build.SourcesDirectory)拼接仓库内相对路径，比如脚本在仓库根目录sql文件夹下，路径为$(Build.SourcesDirectory)/sql/test.sql
  • 发布阶段：用$(System.ArtifactsDirectory)拼接下载的工件路径，比如$(System.ArtifactsDirectory)/SQLScripts/test.sql

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