Azure Data Factory中Foreach循环遍历全局参数报错求助

常见错误场景及修正 #

最常见的错误是直接在@array中写入全局参数名称字符串，而非正确引用参数的实际值。比如错误写法：

@array("GlobalParam1", "GlobalParam2")

这种写法只会生成包含参数名称的字符串数组，而非参数的实际值，会导致后续遍历逻辑触发报错。

正确写法 #

要引用全局参数的实际值，需通过pipeline().globalParameters对象访问，正确的数组声明格式如下：

@array(pipeline().globalParameters.GlobalParam1, pipeline().globalParameters.GlobalParam2)

如果你的全局参数名称包含特殊字符（比如空格、连字符），需要用方括号语法包裹：

@array(pipeline().globalParameters['Global Param 1'], pipeline().globalParameters['Global-Param-2'])

额外验证步骤 #

• 确认全局参数已发布到数据工厂生产环境：仅在设计器中保存但未发布的参数无法被运行时访问。
• 检查参数类型匹配：如果Foreach循环的遍历逻辑依赖特定数据类型（比如字符串、整数），确保选中的全局参数类型与后续逻辑兼容。
• 测试表达式：在ADF的表达式编辑器中点击“测试”按钮，验证生成的数组是否正确返回参数值列表。

内容的提问来源于stack exchange，提问作者R. Maier