Azure AI Search添加向量字段后索引为空问题咨询

关于metadata_storage_path作为索引键的警告 #

该警告并非已知Bug，属于Azure AI Search针对ADLS Gen2数据源的设计提示：

• 当索引键使用metadata_storage_path时，Blob的存储路径作为唯一标识。若后续重命名目录，Blob路径会变更，旧索引条目无法被自动更新（因为索引键已改变）。
• 提示中提到的"更新Blob的LastModified时间戳"是触发索引器重新处理这些Blob的标准操作，属于预期行为。

索引为空的排查方向 #

索引器运行成功但无文档写入，和向量字段添加后的配置缺失直接相关，建议从以下几点排查：

• 向量字段关联缺失：若向量是通过技能集生成，需确保向量生成技能的输出已正确映射到索引的Collection(Edm.Single)类型向量字段。即使未手动映射，若技能集未生成有效输出，也不会有文档写入。
• 数据源筛选限制：检查数据源是否设置了Blob筛选规则（如后缀、路径前缀），导致没有符合条件的Blob被选中处理。
• 索引器高水位线限制：若这些Blob之前已被索引器处理过，索引器默认仅处理LastModified时间晚于上次运行时间的Blob。可通过重置索引器的高水位线，或手动更新Blob的LastModified时间，强制重新处理所有内容。
• 技能集执行异常：查看索引器的执行日志，确认OCR、合并技能是否生成了有效文本输出。若前置技能输出为空，向量生成技能无内容可处理，最终不会生成可写入索引的文档。
• 向量维度匹配验证：确认默认向量器的输出维度与索引字段的1536维度一致（如Azure OpenAI的text-embedding-ada-002输出维度即为1536），维度不匹配会导致文档写入失败（通常会触发错误而非静默无输出）。

综上，你遇到的索引为空问题不属于已知Bug，而是配置或执行环节的疏漏；metadata_storage_path的警告是正常设计提示，并非Bug。

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