Azure Data Factory显式映射失效问题求助

问题场景 #

我有一个用于读取无表头Excel文件并复制到数据库的Azure Data Factory管道，原列映射JSON配置如下：

{
    "type": "TabularTranslator",
    "mappings": [
        {
            "source": {
                "name": "Prop_0"
            },
            "sink": {
                "name": "Name"
            }
        },
        {
            "source": {
                "name": "Prop_1"
            },
            "sink": {
                "name": "ID(Sort)"
            }
        },
        {
            "source": {
                "name": "Prop_2"
            },
            "sink": {
                "name": "Phone Number(P/O)"
            }
        }
   ]
}

该管道此前运行正常，但近期持续报错：

ErrorCode=MappingColumnNameNotFoundInSourceFile,'Type=Microsoft.DataTransfer.Common.Shared.HybridDeliveryException,Message=Column 'Prop_1' specified in column mapping cannot be found in 'User.xlsx' source file.,Source=Microsoft.DataTransfer.ClientLibrary,'

我已尝试以下操作：

• 仅保留Prop_0单个字段的JSON映射可正常运行，但多字段映射时仍报错
• 手动配置列映射可正常运行
• 将JSON映射中source的name字段替换为ordinal字段（如将"name": "Prop_0"改为"ordinal": 1）可正常运行

原因分析 #

这大概率是ADF对无表头Excel列名生成逻辑的隐性变更导致的，可能的具体原因包括：

1. ADF近期引擎更新调整了无表头数据源的列名生成规则，不再稳定生成Prop_0、Prop_1这类格式的列名；
2. 多字段映射场景下，TabularTranslator对name字段的匹配逻辑出现bug，单字段时能正常识别，多字段时解析顺序或列识别出现偏差；
3. 源Excel文件存在隐藏列、全空列或格式异常，导致ADF识别列数时出错，无法匹配到Prop_1。

解决方案 #

1. 优先使用ordinal字段映射（推荐） #

无表头Excel的列位置是固定的，用列序号映射完全不受列名生成逻辑变更的影响，是最稳定的方案。注意ADF中ordinal的起始值通常为0（对应第一列），修改后的配置示例：

{
    "type": "TabularTranslator",
    "mappings": [
        {
            "source": {
                "ordinal": 0
            },
            "sink": {
                "name": "Name"
            }
        },
        {
            "source": {
                "ordinal": 1
            },
            "sink": {
                "name": "ID(Sort)"
            }
        },
        {
            "source": {
                "ordinal": 2
            },
            "sink": {
                "name": "Phone Number(P/O)"
            }
        }
   ]
}

2. 检查并修复源Excel格式 #

确认源Excel文件没有隐藏列、合并单元格或全空列，这些异常格式会干扰ADF的列识别逻辑，修复后再测试管道运行。

3. 导出手动配置的映射JSON #

手动在ADF界面配置列映射，完成后导出对应的JSON参数替换原管道的映射配置。手动配置的映射会自动适配当前ADF的列识别规则，避免自定义JSON的兼容性问题。

4. 验证集成运行时版本 #

如果使用自托管集成运行时，检查是否有自动更新导致版本变更，必要时回退到之前运行稳定的版本（若有备份）。

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