Azure认知搜索完全短语匹配查询返回非完全匹配结果问题

核心问题点 #

你的查询存在两个关键问题：

• 参数使用错误：你写的parameterName=propertyName不是Azure搜索指定搜索字段的正确参数，正确参数应为searchFields=propertyName。即便当前结果来自propertyName字段，这个参数错误也可能引发潜在的匹配范围问题。
• 短语查询逻辑误解：你使用queryType=Full（Lucene查询语法）时，"building"作为短语查询，匹配的是字段中包含独立"building"单词的内容（比如"SILVER BUILDING"里的BUILDING是独立词项，会被命中），而非字段值完全等于"building"。你实际需要的是精确值匹配，不是包含短语的匹配。

正确查询写法 #

根据你的需求，分两种场景给出方案：

1. 精确匹配字段值为"building"：
   • 更推荐用筛选器实现，性能更优：

     search=*&$filter=propertyName eq 'building'&queryType=Full
     

   • 或者用Lucene精确字段短语查询：

     search=propertyName:"building"&searchFields=propertyName&queryType=Full
     

2. 匹配字段中包含完整短语（如"Silver building"）：
   确保指定正确字段并使用短语包裹：

   search="Silver building"&searchFields=propertyName&queryType=Full
   

补充说明 #

Azure搜索默认文本分析器是大小写不敏感的，如果需要大小写敏感匹配，需在字段定义时配置对应分析器。

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