Azure Data Factory中Lookup正常但ForEach无法取值的迁移问题

1. 验证Lookup组件的输出结构 #

• 确保Lookup执行的SQL查询返回SalesLT架构下的表名数组，示例查询：

  SELECT TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'SalesLT'
  

• 查看Lookup的运行输出，确认数据以value数组形式返回（ForEach仅支持遍历数组），输出格式参考：

  {
    "value": [
      {"TABLE_NAME": "Customer"},
      {"TABLE_NAME": "Product"}
    ],
    "count": 2
  }
  

  如果返回的是单条记录而非数组，需调整查询逻辑确保返回多条表名数据。

2. 修正ForEach的迭代项配置 #

• 进入ForEach组件的设置面板，将迭代项设置为：

  @activity('你的Lookup组件名称').output.value
  

  必须指定到value字段，直接使用@activity('Lookup名称').output会导致ForEach无法识别可遍历集合。

3. 检查内部复制活动的参数绑定 #

• 复制活动的SQL数据源表名需绑定ForEach的迭代项，示例配置：
  • 数据集的表名属性设置为：@concat('SalesLT.', item().TABLE_NAME)
  • 确保参数item().TABLE_NAME与Lookup返回的字段名完全匹配（比如Lookup返回的是TABLE_NAME就不能写成TableName）

4. 排查权限与连接问题 #

• 确认自托管集成运行时对本地SQL Server的SalesLT架构下所有表有读取权限
• 验证ADF服务主体对Azure Data Lake Gen2存储账户拥有Storage Blob Data Contributor角色，确保写入权限正常

5. 分析详细错误日志 #

• 在ADF监控页面点击失败的ForEach实例，查看内部复制活动的具体错误信息：
  • 是否存在表名拼写错误或表不存在的情况
  • 是否有个别表的访问权限不足
  • 是否出现数据类型不兼容的转换错误

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