Azure Cognitive Search语义搜索是否支持绑定Edm.ComplexType中的内容字段？

问题原因 #

Azure Cognitive Search的门户界面目前不支持将嵌套在Edm.ComplexType集合中的字段指定为语义内容字段，只能通过编程方式完成配置。

可行解决方案 #

可以通过REST API或Azure CLI两种方式更新索引的语义配置，实现对复杂类型字段的语义搜索启用。

方法1：使用REST API更新索引 #

1. 构造索引更新请求，通过点标记法引用复杂类型集合内的字段（例如你的复杂类型字段为documents、内容字段为content，则用documents/content指代）。
2. 示例请求体：

{
  "semanticSettings": {
    "configurations": [
      {
        "name": "default",
        "prioritizedFields": {
          "titleField": null,
          "prioritizedContentFields": [
            {
              "fieldName": "documents/content"
            }
          ],
          "prioritizedKeywordsFields": []
        }
      }
    ]
  }
}

3. 发送PATCH请求至索引的REST API端点：https://[搜索服务名称].search.windows.net/indexes/[索引名称]?api-version=2023-11-01，请求头中携带管理员密钥作为api-key参数。

方法2：使用Azure CLI更新索引 #

1. 先将当前索引配置导出至本地JSON文件：

az search index show --name <你的索引名称> --resource-group <资源组名称> --service-name <搜索服务名称> > index-config.json

2. 打开index-config.json，添加或修改semanticSettings部分，同样用点标记法指定复杂类型内的内容字段，格式与REST API示例一致。
3. 导入更新后的索引配置：

az search index create --name <你的索引名称> --resource-group <资源组名称> --service-name <搜索服务名称> --file index-config.json --merge true

注意事项 #

• 确保复杂类型中的content字段已设置为可检索（retrievable）和可搜索（searchable），否则无法作为语义内容字段使用。
• 语义搜索要求搜索服务为**标准层（Standard）**或更高层级，且已启用语义搜索功能。

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