Azure Data Factory无法向Dynamics 365 Incident表插入新记录求助

针对你遇到的Azure Data Factory（ADF）向Dynamics 365 CE的Incident表执行Upsert时无法插入新记录、报错-2147220891: Cannot find record to be updated的问题，可从以下几个方向排查：

1. 检查Upsert匹配键的配置 #

ADF的Dynamics接收器Upsert模式依赖匹配键判断执行插入还是更新。如果匹配键设置错误，会导致插入逻辑异常：

• 若误将incidentid（主键，插入时由系统自动生成）设为匹配键，但新记录未提供该值，系统会因找不到匹配记录尝试插入，但若ADF配置未正确处理“无匹配键时插入”的逻辑，就会抛出错误。
• 若错误指定关联字段（如客户ID）作为匹配键，而新记录中该字段对应的关联记录不存在，也会导致插入失败。
  建议将匹配键改为Dynamics默认的主键incidentid，且新记录不传入该字段的值，由系统自动生成。

2. 排查Incident表的隐藏必填字段 #

Dynamics 365的Incident表可能存在系统级必填字段或业务规则控制的隐藏必填字段，ADF的元数据可能未识别到这些字段，但Dynamics导入向导会自动填充或触发默认值：

• 例如customerid（客户关联字段）是Incident的核心必填项，若仅填写表面可见的必填字段但遗漏该字段，插入会失败，但更新时因已有关联记录可正常执行。
• 检查业务规则：是否有隐藏字段被设置为必填，且未在ADF的字段映射中填充。

3. 验证服务账号的权限 #

确认ADF连接Dynamics使用的服务账号，是否拥有创建Incident记录的权限：

• 其他表能正常Upsert不代表Incident表权限一致，可能该账号所在的安全角色仅被授予了Incident的更新权限，未授予创建权限。
• 登录Dynamics后台，在安全角色中找到该账号对应的角色，检查Incident表的权限设置，确保“创建”权限为允许。

4. 检查ADF接收器的特殊配置 #

• 若启用了Bulk Insert API，Incident表可能存在兼容性问题，尝试关闭该选项再测试插入。
• 确认接收器的Write Behavior确实设置为Upsert，且未勾选任何仅允许更新的特殊选项。

5. 排查系统自动生成字段的冲突 #

部分Incident表的系统字段（如incidentnumber）是自动生成的，若ADF的数据源向该字段传入了空值或无效值，会导致插入失败，但更新时因已有合法值可正常执行：

• 在ADF的字段映射中，移除对这类自动生成字段的映射，让Dynamics系统自动填充。

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