Azure搜索服务Indexer字段映射异常问题求助

核心问题原因 #

• 未配置Blob内容的JSON解析模式，Azure搜索默认将Blob视为纯文本，导致字段映射失效或自动创建时存入chunk字段。
• 字段映射未正确引用嵌套JSON路径，且未明确指定Key字段的来源（默认用Blob哈希值）。

分步解决方案 #

1. 创建符合需求的Index结构 #

提前定义所有要存储的字段，包括顶层字段和嵌套字段（平展存储更利于搜索性能）：

{
  "name": "你的索引名称",
  "fields": [
    { "name": "id", "type": "Edm.String", "key": true, "filterable": true },
    { "name": "modelo", "type": "Edm.String", "searchable": true, "filterable": true },
    { "name": "processador", "type": "Edm.String", "searchable": true }
  ]
}

• 若需保留嵌套对象caracteristicas，可定义"name": "caracteristicas", "type": "Edm.ComplexType"并添加Processador子字段，但平展字段搜索效率更高。

2. 配置Indexer的JSON解析模式 #

在Indexer配置中添加parsingMode为json（单个Blob对应一个JSON文档时使用），同时完善字段映射：

{
  "name": "你的索引器名称",
  "dataSourceName": "你的数据源名称",
  "targetIndexName": "你的索引名称",
  "parsingMode": "json",
  "fieldMappings": [
    // 可选：用JSON内的modelo作为id，替代默认Blob哈希值
    { "sourceFieldName": "modelo", "targetFieldName": "id" },
    { "sourceFieldName": "modelo", "targetFieldName": "modelo" },
    // 用点路径引用嵌套字段
    { "sourceFieldName": "caracteristicas.Processador", "targetFieldName": "processador" }
  ]
}

• 若Blob内是JSON数组（一个Blob包含多个JSON对象），则parsingMode设为jsonArray。

3. 解决自动创建存入chunk的问题 #

使用搜索服务面板自动创建时，在数据源配置步骤中将“解析模式”改为JSON（单个文档）或JSON数组，而非默认的“文本”模式，系统会自动识别JSON字段并生成对应Index结构。

验证方法 #

运行Indexer后，通过搜索服务“搜索资源管理器”执行查询：

search=*&$select=id,modelo,processador

确认所有字段已正确填充值。

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