你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

启用或禁用语义排序器

语义排序器是一项高级功能，按使用情况计费。 默认情况下，语义排序器在创建新搜索服务时处于关闭状态，但具有参与者权限的任何人都可以启用它。 如果不想无意中启用语义排序器，可以使用 REST API 进行禁用。

检查可用性

若要确认你的区域中是否有语义排序器，请参阅 Azure AI 搜索区域列表。

启用语义排序器

按照以下步骤在服务级别启用语义排序器。 启用后，它可供所有索引使用。 不能为特定索引打开或关闭它。

Azure 门户

1. 打开 Azure 门户。

2. 导航到你的搜索服务。 在“概述”页上，确保定价层设置为“基本”或更高。

3. 在左侧导航窗格中，选择“设置”>“语义排序器”。

4. 选择“免费计划”或“标准计划”。 可以随时在免费计划与标准计划之间切换。

   

免费计划上限为每月 1000 条查询。 执行了免费计划的前 1,000 次查询后，再尝试进行语义查询时，系统会显示错误消息，指示查询配额已用尽。 当查询配额用完时，应升级到标准计划，这样才能继续使用语义排名。

REST

若要使用 REST API 启用语义排序器，可以使用创建或更新服务 API。

将会通过 Microsoft Entra ID 对管理 REST API 调用进行身份验证。 有关如何进行身份验证的说明，请参阅使用 REST API 管理 Azure AI 搜索服务。

• 管理 REST API 版本 2023-11-01 提供了配置属性。

• 需要拥有所有者或参与者权限才能启用或禁用功能。

注意

创建或更新支持两种 HTTP 方法：PUT 和 PATCH。 PUT 和 PATCH 都可用于更新现有服务，但只有 PUT 可以用来创建新服务。 使用 PUT 来更新现有服务时，如果未在请求中指定属性，则会将服务中的所有属性替换为默认值。 使用 PATCH 来更新现有服务时，它只会替换请求中指定的属性。 使用 PUT 更新现有服务时，可能会意外引入意外的缩放或配置更改。 在现有服务上启用语义排名时，建议使用 PATCH 而不是 PUT。

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2023-11-01
    {
      "properties": {
        "semanticSearch": "standard"
      }
    }

使用 REST API 禁用语义排序器

若要关闭功能启用，或为了充分防止意外使用和收费，你可以在搜索服务上使用创建或更新服务 API 禁用语义排序器。 禁用该功能后，任何包含语义查询类型的请求都将被拒绝。

将会通过 Microsoft Entra ID 对管理 REST API 调用进行身份验证。 有关如何进行身份验证的说明，请参阅使用 REST API 管理 Azure AI 搜索服务。

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2023-11-01
    {
      "properties": {
        "semanticSearch": "disabled"
      }
    }

若要重新启用语义排序器，请重新运行之前的请求，并将 semanticSearch 设置为“Free”（默认值）或“Standard”。

下一步

配置语义排序器