ADF Excel转SQL复制任务报错：MappingColumnNameNotFound（Prop_1未找到）

紧急修复方案 #

• 改用索引映射替代Prop_X命名：直接在映射JSON中用ordinal字段指定源列的位置索引（从0开始计数），绕开Prop_X命名的兼容性问题，示例如下：

  {
      "type": "TabularTranslator",
      "typeConversion": true,
      "typeConversionSettings": {
          "culture": "en-gb"
      },
      "mappings": [
          {
              "source": {
                  "ordinal": 0
              },
              "sink": {
                  "name": "EmployeeID"
              }
          },
          {
              "source": {
                  "ordinal": 1
              },
              "sink": {
                  "name": "Forename"
              }
          }
      ]
  }
  

根因排查与优化步骤 #

• 确认数据集表头配置：检查Excel数据集的First row as header选项是否为未勾选状态，误勾选会导致ADF尝试读取不存在的表头，引发映射逻辑混乱。
• 刷新数据集元数据缓存：在数据集页面点击「刷新」按钮，强制ADF重新读取Excel文件的最新结构，避免旧缓存导致的列识别错误。
• 验证Excel文件完整性：确保文件为标准.xlsx格式，排查工作表是否存在隐藏列、合并单元格或损坏的单元格结构，此类问题会干扰ADF的列识别逻辑。
• 通过UI重新生成映射：在复制活动的映射页面点击「导入映射」，选择自动生成源到目标的映射，此时生成的映射会直接使用列序号而非Prop_X，保存后测试运行。

临时规避技巧 #

若必须使用命名式映射，可尝试：

• 给Excel文件添加临时表头行（如Col1、Col2），勾选数据集的First row as header选项，映射时使用临时表头名替代Prop_X，任务完成后移除临时表头（适合一次性任务）。
• 改用ADF数据流动：数据流动对无表头Excel的列识别更稳定，可通过「位置模式」直接按列索引配置映射。

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