ADF数据流中Import Projection为何将列名改为奇怪格式？

问题复现 #

使用ADF Data Flow的Import Projection功能时，列名被自动重命名为异常格式；但点击重置架构后，系统推断出的列名符合预期，且这种列名不匹配导致无法在Data Preview标签页刷新查看数据。同时，数据集导入的架构与数据流源中Import Projection得到的架构存在明显差异。

解决方法 #

1. 清除数据流元数据缓存 #

• 数据流编辑器顶部刷新图标旁的下拉菜单里，点击清除缓存，之后重新执行Import Projection。ADF的旧元数据缓存常会导致投影读取到过期信息。
• 若编辑器缓存无效，针对自托管集成运行时，进入配置页重启IR；托管IR可等待缓存自动失效，或先提交发布再测试。

2. 校准数据集架构配置 #

• 确认数据集的架构设置为从连接/存储推断，避免使用手动指定的旧架构。如果数据集是手动定义架构，Import Projection会优先读取该架构而非实时推断结果。
• 重新保存数据集后，回到数据流源点击刷新数据集架构，再尝试Import Projection。

3. 手动同步投影与正确架构 #

• 先点击重置架构获取正确列名，再手动修正投影列名：
  1. 点击数据流源的重置架构，等待系统生成正确列名。
  2. 切换到投影标签，将每个异常列名修改为重置后的名称。
  3. 保存数据流后重新测试Data Preview。

4. 规范数据源列名处理规则 #

• 若数据源（如CSV、Parquet）列名含特殊字符（空格、中文、特殊符号），Import Projection可能会自动转义成异常格式，而重置架构会保留原始格式：
  • 在数据源连接配置中设置列名处理规则（比如CSV数据集的「列名格式」选项），统一列名格式后再导入投影。
  • 直接在投影中手动修正列名，确保与数据源实际列名完全匹配。

5. 发布后验证 #

• 编辑器预览环境和发布后的运行环境可能存在元数据差异，先发布数据流所在的管道，再在发布环境中测试Data Preview。

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