Azure DevOps库变量无法传入Azure Data Factory管道问题咨询

核心结论 #

Azure DevOps库中的变量不会自动同步为Azure Data Factory（ADF）管道的内置变量，必须通过DevOps部署管道显式传递，才能在ADF运行时生效。

常见排查点 #

• 确认变量传递配置
  在DevOps的ADF部署任务中，需在Override template parameters或Additional Arguments字段里定义变量映射，示例格式：

  -p:MorisEmail=$(moris@aix.com) -p:LowesEmail=$(lowes@aix.com)
  

  同时要确保ADF管道已提前定义对应的参数（如MorisEmail、LowesEmail），否则无法接收传递的值。

• 检查变量库权限
  验证DevOps部署管道使用的服务主体/托管标识，是否拥有目标变量库的读取权限，无权限会导致变量无法被读取。

• 确认变量作用域关联
  确保变量库的变量已关联到当前DevOps管道的对应作用域（如特定阶段、环境），未关联的变量无法被管道引用。

• 查看部署日志
  打开DevOps部署任务的日志，搜索目标变量名称，确认变量是否被正确读取并传递到ADF部署参数中。若日志中变量值为空或未出现，说明变量引用或权限存在问题。

• ADF管道参数引用验证
  检查ADF管道活动中是否正确引用参数，需使用@pipeline().parameters.MorisEmail这类格式，而非直接写死字符串值。

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