Azure Data Factory Foreach复制Upsert：如何配置各表专属键列

核心思路 #

不要在全局复制活动的Upsert设置里统一填写键列，而是针对每张表单独配置映射和Upsert规则，具体可通过以下两种方式实现：

方式1：通过表映射高级编辑器单独配置 #

• 进入复制活动的「映射」标签，切换到高级编辑器模式
• 找到对应表的映射条目，在Sink节点下添加upsertSettings属性，指定该表的专属键列：

  {
    "source": {
      "name": "mysql_source_table1"
    },
    "sink": {
      "name": "sql_server_target_table1",
      "upsertSettings": {
        "keyColumns": ["id", "order_no"]
      }
    }
  }
  

• 对每张需要启用Upsert的表重复上述操作，分别定义各自的keyColumns数组

方式2：参数化复制活动适配批量多表场景 #

如果是通过ForEach活动批量复制多张表，可按以下步骤配置：

1. 预先维护一张配置表（可存储在SQL Server或ADF数据集内），包含表名、源键列、目标键列三个核心字段
2. 在ForEach活动中循环读取配置表的每条记录，将表名、键列作为参数传入复制活动
3. 在复制活动的「接收器」设置中，将Upsert键列设置为动态参数：
   • 键列输入框使用表达式：@split(item().key_columns, ',')（假设配置表中key_columns字段以逗号分隔存储列名，如"id,user_id"）

注意事项 #

• 确保源表与目标表的键列数据类型完全匹配，否则会导致Upsert执行失败
• 使用自动映射时，需先确认字段映射关系正确，再添加Upsert键列配置
• 批量处理场景下，配置表的键列定义必须准确对应每张表的主键或唯一键，避免出现错误的数据覆盖

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