Azure Data Factory Copy Activity单条XML记录无法写入数据库问题

问题根源 #

ADF的Copy Activity在解析XML时，当目标集合节点Cond_Tbl_Data_Record仅存在单条记录时，会默认将其解析为单个对象而非数组结构，导致你配置的Collection reference无法正确识别这条记录，最终无法写入数据库。

解决方案 #

1. 改用Data Flow处理XML数据 #

Data Flow对XML的单/多节点兼容性更好：

• 创建一个Data Flow，添加XML源并指定源文件路径；
• 在源的设置中，将Collection reference设置为Cond_Tbl_Data_Set/Cond_Tbl_Data_Record；
• 直接映射XML字段到数据库目标表的对应列，运行数据流即可自动处理单条或多条记录的场景。

2. 调整Copy Activity的XML格式设置 #

如果坚持使用Copy Activity，可强制解析器将单元素视为数组：

• 打开XML源数据集的格式设置；
• 找到并勾选**“将单元素视为数组”**；
• 保存设置后重新运行Copy Activity，单条记录即可被正确识别为集合的一部分。

3. 预处理XML文件（兜底方案） #

若上述方法无效，可在Copy Activity前添加预处理步骤：

• 使用Azure Function或Blob存储自定义活动读取XML文件；
• 检查Cond_Tbl_Data_Record节点的数量，若仅为1条，通过字符串替换或XSLT转换，将其包装为数组结构（确保和多条记录的XML结构完全一致）；
• 处理后的XML再传入Copy Activity进行数据写入。

4. Lookup + ForEach组合处理 #

适合需要额外逻辑判断的场景：

• 用Lookup Activity读取XML文件的内容；
• 在后续逻辑中，判断Lookup返回的结果是否为单条记录，若是则手动构造包含该记录的数组；
• 通过ForEach Activity循环遍历数组中的记录，逐条写入数据库。

验证 #

使用仅含单条Cond_Tbl_Data_Record的XML文件测试上述任一方案，确认数据能正常写入目标数据库。

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