ADF分段复制未应用架构映射，如何让映射生效？

1. 把架构映射明确配置在复制活动的映射节点 #

分段复制模式下，数据会先写入中间存储再同步到目标，仅在源/接收器节点配置字段定义无法被分段流程识别。必须直接在复制活动的translator节点里定义完整的字段映射，包括字段对应关系和类型匹配，示例配置片段：

"activities": [
    {
        "name": "CopyFromSOAPToSQL",
        "type": "Copy",
        "typeProperties": {
            "source": { "type": "SoapSource" },
            "sink": { "type": "AzureSqlSink" },
            "enableStaging": true,
            "stagingSettings": {
                "linkedServiceName": { "referenceName": "BlobStorageLinkedService", "type": "LinkedServiceReference" },
                "path": "staging-container/temp-files"
            },
            "translator": {
                "type": "TabularTranslator",
                "columnMappings": "SourceField1 -> TargetColumn1, SourceField2 -> TargetColumn2"
            }
        }
    }
]

2. 强制指定中间存储的文件格式适配SOAP返回数据 #

分段时默认的临时文件格式可能和SOAP返回的结构化数据不兼容，导致字段丢失。需要在stagingSettings里显式配置文件格式，比如SOAP返回XML时：

"stagingSettings": {
    "linkedServiceName": { "referenceName": "BlobStorageLinkedService", "type": "LinkedServiceReference" },
    "path": "staging-container/temp-files",
    "fileExtension": ".xml",
    "formatSettings": {
        "type": "XmlFormat",
        "xpath": "//YourSOAPResponseNode/Records"
    }
}

如果是JSON格式的SOAP响应，替换为JsonFormat并指定jsonPathDefinition。

3. 排查源数据的格式兼容性问题 #

分段复制对数据格式校验更严格，若SOAP返回的记录存在字段缺失、类型不匹配（比如字符串转数字失败），会导致映射跳过整批数据，最终只写入空行。可以开启容错设置定位问题：

"typeProperties": {
    "enableSkipIncompatibleRow": true,
    "redirectIncompatibleRowSettings": {
        "linkedServiceName": { "referenceName": "BlobStorageLinkedService", "type": "LinkedServiceReference" },
        "path": "error-logs/incompatible-rows"
    }
}

通过错误日志找到具体字段问题后，在映射中添加类型转换规则（比如用cast函数处理类型差异）。

4. 检查中间存储的权限与生命周期配置 #

若中间存储容器缺乏读写权限，或临时文件被生命周期规则提前删除，会导致分段流程读取不到数据。确认链接服务的身份（比如托管标识）拥有Blob容器的Contributor权限，同时禁用临时容器的自动删除规则，直到复制完成。

5. 验证中间存储的临时文件内容 #

分段流程中，中间存储的临时文件是临时数据源。手动查看这些文件的内容，确认字段是否被正确写入：如果临时文件为空，说明SOAP源到中间存储的第一步就存在问题，需要排查SOAP服务的连接、查询参数是否正确。

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