共用方式為

在 Azure AI 搜尋服務中建立索引別名

  • 發行項

重要

索引別名目前處於公開預覽狀態，並列於增補使用條款。

在 Azure AI 搜尋服務中，索引別名是次要名稱，可用來參考查詢、索引編製和其他作業的索引。 您可以建立對應至搜尋索引的別名，並在您參考索引名稱的位置以此取代別名名稱。 如果您需要變更應用程式所指向的索引，別名可增加作業彈性。 您可以只更新別名的對應，無須更新應用程式中的參考。

索引別名的主要目標是讓您更輕鬆地管理生產索引。 例如，如果您需要變更索引定義，例如編輯欄位或新增分析器，則必須建立新的搜尋索引，因為所有搜尋索引都是固定的。 這表示您必須卸除並重建索引，或者建立新的索引，然後將您的應用程式移轉至該索引。

您可以使用索引別名，而無須卸除和重建索引。 一般工作流程如下：

  1. 建立搜尋索引
  2. 建立可對應至搜尋索引的別名
  3. 讓應用程式將查詢/索引編製要求傳送至別名，而不是索引名稱
  4. 當您變更必須重建的索引時，請建立新的搜尋索引
  5. 當新索引準備就緒，請更新別名以對應至新的索引，要求即可自動路由傳送至新的索引

建立索引別名

您可以使用預覽 REST API、預覽 SDK，或透過 Azure 入口網站來建立別名。 別名包含別名的 name，以及別名所對應的搜尋索引名稱。 您只能在 indexes 陣列中指定一個索引名稱。

您可以使用建立或更新別名 (REST 預覽) 來建立索引別名。

POST /aliases?api-version=2024-05-01-preview
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index"]
}

將要求傳送至索引別名

建立別名後，您就可以開始使用此別名。 別名可用於所有文件作業，包括查詢、索引編製、建議和自動完成等作業。

在下列查詢中，您可以將要求傳送到 my-alias，其會據此路由傳送，而無須將要求傳送到 hotel-samples-index。

POST /indexes/my-alias/docs/search?api-version=2024-05-01-preview
{
    "search": "pool spa +airport",
    "searchMode": any,
    "queryType": "simple",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

如果您預期會更新生產索引，請指定用戶端應用程式中的別名，而非索引名稱。 必須重建索引的案例在卸除並重建索引中有所概述。

注意

您只能搭配文件作業來使用別名，或藉此取得及更新索引定義。 別名無法用來刪除索引、無法與分析文字 API 搭配使用，而且不能作為索引子上的 targetIndexName。

別名的更新可能需要 10 秒才能傳播到整個系統，因此請至少等候 10 秒鐘，再針對索引執行已對應的作業，或是近期已對應至別名的作業。

交換索引

每當您需要更新應用程式以指向新的索引時，只需要更新別名中的對應。 更新程序需要使用 PUT，詳情請參閱建立或更新別名 (REST 預覽)。

PUT /aliases/my-alias?api-version=2024-05-01-preview
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index2"]
}

更新別名之後，要求會開始自動路由傳送至新的索引。

注意

別名的更新可能需要 10 秒才能傳播到整個系統，因此請至少等候 10 秒鐘，再刪除別名先前所對應的索引。

另請參閱