Een indexalias maken in Azure AI Search

  • Artikel

Belangrijk

Indexaliassen zijn momenteel beschikbaar als openbare preview en zijn beschikbaar onder aanvullende gebruiksvoorwaarden.

In Azure AI Search is een indexalias een secundaire naam die kan worden gebruikt om te verwijzen naar een index voor query's, indexering en andere bewerkingen. U kunt een alias maken die is toegewezen aan een zoekindex en de aliasnaam vervangen op plaatsen waar u anders naar een indexnaam zou verwijzen. Een alias voegt flexibiliteit toe als u wilt wijzigen naar welke index uw toepassing verwijst. In plaats van de verwijzingen in uw toepassing bij te werken, kunt u de toewijzing voor uw alias bijwerken.

Het belangrijkste doel van indexaliassen is om het beheer van uw productieindexen gemakkelijker te maken. Als u bijvoorbeeld een wijziging wilt aanbrengen in de indexdefinitie, zoals het bewerken van een veld of het toevoegen van een nieuwe analyse, moet u een nieuwe zoekindex maken omdat alle zoekindexen onveranderbaar zijn. Dit betekent dat u de index moet verwijderen en herbouwen of een nieuwe index moet maken en vervolgens uw toepassing naar die index moet migreren.

In plaats van uw index te verwijderen en opnieuw te bouwen, kunt u indexaliassen gebruiken. Een typische werkstroom is het volgende:

  1. Uw zoekindex maken
  2. Een alias maken die is toegewezen aan uw zoekindex
  3. Laat uw toepassing query's/indexeringsaanvragen verzenden naar de alias in plaats van de indexnaam
  4. Wanneer u een wijziging wilt aanbrengen in uw index waarvoor een herbouw is vereist, maakt u een nieuwe zoekindex
  5. Wanneer de nieuwe index klaar is, werkt u de alias bij zodat deze wordt toegewezen aan de nieuwe index en worden aanvragen automatisch doorgestuurd naar de nieuwe index

Een indexalias maken

U kunt een alias maken met behulp van de PREVIEW REST API, de preview-SDK's of via Azure Portal. Een alias bestaat uit de name alias en de naam van de zoekindex waaraan de alias is toegewezen. Er kan slechts één indexnaam worden opgegeven in de indexes matrix.

U kunt de alias Maken of Bijwerken (REST Preview) gebruiken om een indexalias te maken.

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

Aanvragen verzenden naar een indexalias

Nadat u uw alias hebt gemaakt, kunt u deze gaan gebruiken. Aliassen kunnen worden gebruikt voor alle documentbewerkingen, waaronder query's, indexeren, suggesties en automatisch aanvullen.

In de onderstaande query, in plaats van de aanvraag naar te hotel-samples-indexverzenden, kunt u in plaats daarvan de aanvraag verzenden naar my-alias en deze dienovereenkomstig worden gerouteerd.

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

Als u verwacht updates aan te brengen in een productieindex, geeft u een alias op in plaats van de indexnaam in de toepassing aan de clientzijde. Scenario's waarvoor een herbouw van een index is vereist, worden beschreven in Drop en rebuild an index.

Notitie

U kunt alleen een alias met documentbewerkingen gebruiken of een indexdefinitie ophalen en bijwerken. Aliassen kunnen niet worden gebruikt om een index te verwijderen, kunnen niet worden gebruikt met de Analyze Text-API en kunnen niet worden gebruikt als indexeerfunctie targetIndexName .

Het kan tot 10 seconden duren voordat een update van een alias via het systeem wordt doorgegeven, zodat u ten minste 10 seconden moet wachten voordat u een bewerking uitvoert in de index die is toegewezen of onlangs is toegewezen aan de alias.

Indexen wisselen

Wanneer u uw toepassing nu moet bijwerken om naar een nieuwe index te verwijzen, hoeft u alleen de toewijzing in uw alias bij te werken. PUT is vereist voor updates, zoals beschreven in Create or Update Alias (REST Preview).

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

Nadat u de update naar de alias hebt uitgevoerd, worden aanvragen automatisch doorgestuurd naar de nieuwe index.

Notitie

Het kan tot 10 seconden duren voordat een update van een alias via het systeem wordt doorgegeven, zodat u ten minste 10 seconden moet wachten voordat u de index verwijdert waaraan de alias eerder is toegewezen.

Zie ook