如何在Azure Search中过滤ComplexTypeCollection字段匹配特定文本

一、是否需要修改字段属性？ #

需要。当前TextProperty的searchable属性为false，Azure Search中使用contains函数实现模糊文本匹配时，要求字段必须开启searchable（该属性控制字段是否参与全文检索，支持分词匹配）。仅开启filterable仅能支持精确匹配（如eq），无法实现包含特定文本的模糊过滤。

修改后的TextProperty字段配置需将searchable设为true：

{
  "name": "TextProperty",
  "type": "Edm.String",
  "searchable": true,  // 修改为true
  "filterable": true,
  "retrievable": true,
  "stored": true,
  "sortable": false,
  "facetable": false,
  "key": false,
  "indexAnalyzer": null,
  "searchAnalyzer": null,
  "analyzer": null,
  "normalizer": null,
  "dimensions": null,
  "vectorSearchProfile": null,
  "vectorEncoding": null,
  "synonymMaps": []
}

修改完成后需重新构建索引，确保新配置生效。

二、查询语句写法 #

使用Azure Search的any运算符遍历复杂集合字段，结合contains函数实现“至少一个子项的TextProperty包含指定文本”的过滤逻辑，示例如下：

REST API 请求示例 #

POST /indexes/your-index-name/docs/search?api-version=2023-11-01
Content-Type: application/json

{
  "filter": "ComplexField/any(c: contains(c/TextProperty, 'example'))",
  "select": "id, ComplexField"
}

.NET SDK 代码示例 #

var searchOptions = new SearchOptions
{
    Filter = "ComplexField/any(c: contains(c/TextProperty, 'example'))",
    Select = { "id", "ComplexField" }
};

var response = await searchClient.SearchAsync<YourDocumentType>("*", searchOptions);

逻辑说明 #

• ComplexField/any(c: ...)：遍历ComplexField集合中的每个子项（用c作为别名）
• contains(c/TextProperty, 'example')：检查子项的TextProperty是否包含example文本（默认基于分词匹配，如example text会被匹配到）

如果需要精确字符串子串匹配（不分词，严格匹配文本片段），可将TextProperty的analyzer设置为keyword，此时contains会按完整字符串的子串进行匹配。

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