近期,多位 Microsoft Fabric 用户反馈,在使用 Copy Data Activity 的 Mapping 选项卡时,通过 JSON payload 自定义字段映射的功能出现异常,导致数据复制任务失败或产生错误结果。该问题主要影响依赖高级映射配置的复杂数据管道,部分用户因此不得不暂停关键业务数据同步流程。

问题重现:Mapping 选项卡 JSON 输入无响应

据用户报告,当在 Fabric 数据工厂的 Copy Data Activity 中进入 Mapping 选项卡,尝试直接编辑或粘贴 JSON 格式的字段映射配置时,界面无法正确解析输入内容。部分用户表示,JSON payload 提交后,系统返回“Invalid mapping definition”错误,但检查语法无误;另有用户反映,编辑后的映射在保存后自动回滚至默认状态,导致源与目标字段匹配失效。

一位来自金融科技公司的数据工程师在社区论坛中详细描述了操作步骤:“我们在源数据表新增了一个嵌套 JSON 字段,需要在目标表中拆分为多个列。按照文档指导,我们在 Mapping 选项卡中手动添加了 JSON 表达式,但点击确认后,界面立即清空了我们的配置,并用系统自动生成的映射覆盖。”该工程师强调,此前在 Azure Data Factory 中相同的 JSON 映射逻辑运行正常,迁移至 Fabric 后却频繁报错。

影响范围:主要波及复杂映射场景

从目前收集的反馈来看,问题集中出现在以下场景中:
- 使用动态映射(Dynamic Mapping)且涉及键值对转换;
- 需要处理层次化 JSON 结构,如数组展开、属性重命名;
- 结合参数化数据集或表达式函数的自定义映射。

对于仅使用简单列对列映射的用户,该问题影响较小。但越来越多的企业正在将 Fabric 用于实时数据分析与数据湖加载,精确的字段映射是确保数据质量的关键。一旦 Mapping 选项卡中的 JSON payload 失效,下游的 Power BI 报表、机器学习模型训练等环节将可能因数据字段错位而中断。

技术分析:底层解析引擎或存在兼容性问题

Fabric Copy Data Activity 继承了 Azure Data Factory 的部分架构,但引入了新的分布式计算执行引擎。有分析人士指出,新引擎在处理用户自定义 JSON 映射时,可能对某些特定的语法结构(如嵌套的 $['field'] 表达式或 IF 条件分支)存在兼容性问题。此外,Fabric 中 Mapping 选项卡的 UI 组件与后端 API 之间的数据交互也可能出现状态同步漏洞,导致前端传递的 payload 被错误截断或格式转换。

部分开发者尝试通过在活动级别设置“Advanced editor”模式(代码视图)来绕过 UI 问题,直接在 JSON 编辑器中编写映射。然而,即便在代码视图中保存,返回可视化 Mapping 选项卡后,系统依然可能报“Unexpected token”错误,表明问题不仅存在于前端,也涉及后端的映射验证逻辑。

官方回应:确认问题并发布临时解决方案

截至发稿前,Microsoft 官方已在其 Fabric 公告页面发布了“已知问题”列表,将“Copy Data Activity Mapping tab JSON payload not working”列为 P2 级别(高优先级)问题。官方表示,工程团队正在修复底层映射解析器中的缺陷,预计将在未来两周内通过后端热修复解决。

同时,官方提供了两项临时解决方案:
1. 使用“Import mapping”功能,从本地文本文件加载 JSON 映射配置(避免在 UI 中二次编辑)。
2. 在 Copy Data Activity 的 Source 和 Sink 中直接使用查询语句(如 SQL 或 KQL)完成字段转换,跳过 Mapping 选项卡。

不过,第二种方法要求用户具备较强的查询编写能力,且无法直接处理文件型数据源(如 Parquet 或 JSON 文件)的复杂映射。

行业建议:监控更新并做好回滚预案

对于当前依赖 Fabric 进行数据同步的用户,建议:
- 将受影响的活动暂时切换至“Auto mapping”模式,确保数据管道的基本流转不中断。
- 定期检查 Fabric 发布日志,获取修复补丁发布信息。
- 保留一份已知可用的 Mapping 配置 JSON 备份,以在修复后快速恢复。

随着数据工程向低代码与可视化方向演进,Mapping 选项卡的稳定性直接关系到 Fabric 在生产环境中的可信度。此次问题虽被定位为临时性缺陷,但也暴露出新平台在高阶配置场景下的成熟度仍有提升空间。微软需加速修复进程,并加强对于复杂 JSON 映射场景的自动化回归测试,避免类似问题在后续升级中再次出现。