Sdílet prostřednictvím

Vytvoření aliasu indexu ve službě Azure AI Search

  • Článek

Důležité

Aliasy indexů jsou aktuálně ve verzi Public Preview a jsou k dispozici v dodatečných podmínkách použití.

Ve službě Azure AI Search je alias indexu sekundárním názvem, který se dá použít k odkazování na index pro dotazování, indexování a další operace. Můžete vytvořit alias, který se mapuje na index vyhledávání, a nahradit název aliasu na místech, kde byste jinak odkazoval na název indexu. Alias zvyšuje flexibilitu, pokud potřebujete změnit index, na který aplikace odkazuje. Místo aktualizace odkazů ve vaší aplikaci můžete mapování aliasu aktualizovat.

Hlavním cílem aliasů indexů je usnadnit správu produkčních indexů. Pokud například potřebujete změnit definici indexu, například upravit pole nebo přidat nový analyzátor, budete muset vytvořit nový index vyhledávání, protože všechny indexy vyhledávání jsou neměnné. To znamená, že buď potřebujete odstranit a znovu sestavit index , nebo vytvořit nový index a pak migrovat aplikaci na tento index.

Místo vyřazení a opětovného sestavení indexu můžete použít aliasy indexu. Typickým pracovním postupem by bylo:

  1. Vytvoření vyhledávacího indexu
  2. Vytvoření aliasu, který se mapuje na index vyhledávání
  3. Požádejte aplikaci, aby místo názvu indexu odesílala požadavky na dotazování nebo indexování do aliasu.
  4. Pokud potřebujete provést změnu indexu, která vyžaduje opětovné sestavení, vytvořte nový index vyhledávání.
  5. Až bude nový index připravený, aktualizujte alias tak, aby se mapoval na nový index, a požadavky se automaticky směrují do nového indexu.

Vytvoření aliasu indexu

Alias můžete vytvořit pomocí rozhraní REST API verze Preview, sad SDK ve verzi Preview nebo prostřednictvím webu Azure Portal. Alias se skládá z name aliasu a názvu indexu vyhledávání, na který je alias namapovaný. V poli lze zadat pouze jeden název indexu indexes .

Alias pro vytvoření nebo aktualizaci (REST Preview) můžete použít k vytvoření aliasu indexu.

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

Odeslání požadavků na alias indexu

Jakmile alias vytvoříte, můžete ho začít používat. Aliasy se dají použít pro všechny operace s dokumentem, včetně dotazování, indexování, návrhů a automatického dokončování.

V následujícím dotazu můžete místo odeslání požadavku hotel-samples-indexodeslat požadavek my-alias a odpovídajícím způsobem se bude směrovat.

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
}

Pokud očekáváte, že provedete aktualizace produkčního indexu, místo názvu indexu v aplikaci na straně klienta zadejte alias. Scénáře, které vyžadují opětovné sestavení indexu, jsou uvedené v rozevíracím seznamu a znovu sestavte index.

Poznámka:

Alias můžete použít pouze s operacemi dokumentu nebo získat a aktualizovat definici indexu. Aliasy se nedají použít k odstranění indexu, nedají se použít s rozhraním API pro analýzu textu a nedají se použít jako targetIndexName indexer.

Rozšíření aktualizace aliasu v systému může trvat až 10 sekund, takže byste měli počkat alespoň 10 sekund před provedením jakékoli operace v indexu, který byl namapován nebo nedávno namapován na alias.

Prohození indexů

Když teď potřebujete aktualizovat aplikaci tak, aby odkazovat na nový index, stačí aktualizovat mapování v aliasu. Put se vyžaduje pro aktualizace, jak je popsáno v tématu Vytvoření nebo aktualizace aliasu (REST Preview).

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

Po provedení aktualizace aliasu se požadavky automaticky začnou směrovat do nového indexu.

Poznámka:

Rozšíření aktualizace aliasu v systému může trvat až 10 sekund, takže byste měli počkat alespoň 10 sekund před odstraněním indexu, na který byl alias dříve namapován.

Viz také