Azure Data Factory从Rest API复制数据到CSV：CustomerNumber未输出

1. 验证源数据的实际状态 #

• 用ADF的数据预览功能直接查看Rest API返回的原始JSON，确认data.CustomerNumber字段确实存在，且存在非空值。部分场景下该字段可能仅在部分记录中出现，或值为null/空字符串，导致写入CSV时无内容。
• 若data是数组类型，需先通过复制活动的展开设置或Lookup活动拆分数组，确保能正确访问到层级下的CustomerNumber字段。

2. 严格匹配字段映射的大小写 #

• 帕斯卡命名的字段易出现大小写匹配疏漏，直接在高级编辑器中检查映射JSON，确认源字段路径严格为$['data']['CustomerNumber']（大小写完全与API返回一致）。
• 示例正确映射片段：

  {
    "source": {
      "path": "$['data']['CustomerNumber']"
    },
    "sink": {
      "name": "CustomerNumber"
    }
  }
  

• 放弃自动映射，手动编写路径，避免ADF自动转换大小写导致匹配失败。

3. 检查CSV接收器配置 #

• 确认CSV数据集的列分隔符、引用字符设置：如果CustomerNumber值包含分隔符但未配置引用字符，可能被解析为多列，导致最终文件无对应内容。
• 检查CSV数据集的架构，确保包含CustomerNumber列，且数据类型与源字段匹配（比如源为字符串，接收器也设为字符串，避免类型转换失败）。

4. 简化场景测试 #

• 创建仅包含data.CustomerNumber和一个正常字段的最小复制任务，测试是否能正常写入。若可行，逐步添加其他字段，排查是否存在字段冲突或映射逻辑冲突。
• 尝试将数据写入Azure Blob存储的CSV文件，排除本地存储或其他介质的特殊限制。

5. 排查动态内容/表达式问题 #

• 若映射使用了动态内容或表达式，检查是否存在逻辑错误导致CustomerNumber值被过滤或转为空。比如误加的条件判断、错误的字段路径。
• 可添加计算列验证取值：

  @item()['data']['CustomerNumber']
  

6. 分析运行日志 #

• 进入ADF监控页面，查看复制任务的详细运行日志，重点关注数据读取、写入阶段的统计，确认该字段是否被读取到，是否有Skipped columns或Column mapping errors等提示，直接定位问题原因。

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