ADX提示找不到未创建的映射引用，但数据导入成功求助

问题明确 #

在ADX环境下，数据导入时持续抛出错误：

在数据库'myDatabaseName'中找不到类型为'mappingReference'的映射引用'myMappingName'

错误日志关键信息：

"OriginatesFromUpdatePolicy": false,
"ErrorCode": BadRequest_MappingReferenceWasNotFound,

但该映射从未创建、未被任何配置引用，且数据导入完全正常，所有数据均已成功写入。

排查与解决步骤 #

• 核对导入作业的关联配置
  即使未手动创建该映射，自动化脚本、ARM模板、持续导入规则（如事件中心/Blob存储绑定）可能隐式硬编码了myMappingName。运行以下Kusto命令排查数据库和表的导入配置：

  -- 列出数据库所有导入映射
  .show database myDatabaseName ingestion mappings
  -- 列出数据库所有导入策略
  .show database myDatabaseName ingestion policies
  -- 列出所有表的导入策略
  .show table * ingestion policies
  

  重点检查是否有作业配置中存在无效的映射引用。

• 定位报错的具体导入作业
  已删除的作业可能残留配置引用，通过以下命令查询报错作业的详细信息：

  .show operations
  | where OperationId has "BadRequest_MappingReferenceWasNotFound"
  | where DatabaseName == "myDatabaseName"
  | project OperationId, StartTime, Details
  

  根据返回的OperationId查看作业完整配置，确认无效引用来源。

• 检查目标表的默认映射残留
  确认目标表是否存在未关联的映射配置残留：

  .show table [你的目标表名] ingestion mappings
  

  若存在无效配置，可通过.drop table [表名] ingestion mapping [映射名]命令清理。

• 处理元数据一致性问题
  若以上排查无结果，大概率是ADX集群元数据缓存或一致性异常：

  • 尝试重新触发目标表的元数据同步
  • 联系微软技术支持提交集群元数据校验请求

内容的提问来源于stack exchange，提问作者William D'Alessandro