Azure Data Factory：如何将源表列表对应复制到目标表列表？

核心思路 #

用包含源表-目标表对应关系的对象数组作为ForEach活动的迭代项，确保每一次Copy活动都能精准匹配对应的源表和目标表，避免单独维护两个列表导致的顺序错位问题。

具体实现步骤 #

1. 定义管道迭代变量
   在管道中创建一个数组类型的变量（比如命名为tableMappings），将表对应关系以对象形式存入：

   [
       {"sourceTable": "test_cus1", "targetTable": "tar_cus1"},
       {"sourceTable": "test_cust2", "targetTable": "tar_cus2"},
       {"sourceTable": "test_cust3", "targetTable": "tar_cust3"}
   ]
   

2. 配置ForEach活动

   • 迭代项设置为 @variables('tableMappings')
   • 若需避免数据库负载过高，勾选「Sequential」（顺序执行）；允许并行则保持默认并行设置

3. 嵌套Copy活动配置
   以Azure SQL作为源和目标链接服务，分别配置两端：

   • 源端设置：
     选择「Query」作为数据源类型，输入查询语句：

     SELECT * FROM [@{item().sourceTable}]
     

     （加方括号避免表名含特殊字符导致解析错误）
   • 目标端设置：
     选择「Table」作为目标类型，直接填写表名：

     [@{item().targetTable}]
     

     若使用数据集参数，可创建带targetTable参数的目标数据集，将参数值设为 @item().targetTable

4. 可选：清空目标表再复制
   在Copy活动的「Sink」设置中，勾选「Pre-copy script」，输入清空脚本：

   TRUNCATE TABLE [@{item().targetTable}]
   

   注意需确保ADF的身份具备目标表的TRUNCATE权限

常见失败排查点 #

• 权限问题：检查ADF所用的托管身份/服务主体，是否拥有源表的SELECT权限、目标表的INSERT（及TRUNCATE若用预脚本）权限
• 表名拼写错误：核对迭代数组里的表名与数据库中实际表名完全一致，注意大小写（Azure SQL默认区分大小写取决于数据库 collation）
• 表结构不匹配：确认源表与目标表的列名、数据类型、精度完全对应，否则会因列映射失败报错
• 迭代项引用错误：若用单独的源/目标列表而非对象数组，需确保两个数组长度一致，且用@variables('sourceTables')[index]和@variables('targetTables')[index]索引匹配（但此方式易因顺序变动出错，优先推荐对象数组）

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