Delen via

Een indexalias maken in Azure AI Search

Belangrijk

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

In Azure AI Search is een indexalias een secundaire naam voor een zoekindex. 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. Dit biedt u flexibiliteit als u ooit wilt wijzigen naar welke index uw toepassing verwijst. In plaats van de verwijzingen naar de indexnaam in uw productiecode bij te werken, kunt u de mapping voor uw alias bijwerken.

U kunt aliassen maken en beheren in de Azure AI Search-service via HTTP-aanvragen (POST, GET, PUT, DELETE) voor een bepaalde aliasresource. Aliassen zijn resources op serviceniveau en worden onafhankelijk van zoekindexen onderhouden. Zodra een zoekindex is gemaakt, kunt u een alias maken die is toegewezen aan die zoekindex.

Voordat u een alias gebruikt, verzendt uw toepassing aanvragen rechtstreeks naar hotel-samples-index.

POST /indexes/hotel-samples-index/docs/search?api-version=2025-11-01-preview
{
    "search": "pool spa +airport",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

Nadat u een alias hebt gebruikt, verzendt uw toepassing aanvragen naar my-alias, die worden omgezet naar hotel-samples-index.

POST /indexes/my-alias/docs/search?api-version=2025-11-01-preview
{
    "search": "pool spa +airport",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

Ondersteunde scenario’s

U kunt alleen een alias met documentbewerkingen gebruiken of een indexdefinitie ophalen en bijwerken.

Aliassen kunnen niet worden gebruikt om een index te verwijderen of teksttokenisatie te testen of te verwijzen als targetIndexName of kennisbron.

Een indexalias maken

Door een alias te maken, wordt een toewijzing tot stand gebracht tussen een aliasnaam en een indexnaam. Als de aanvraag is geslaagd, kan de alias worden gebruikt voor indexering, query's en andere bewerkingen.

Als u een alias bijwerkt, kunt u die alias toewijzen aan een andere zoekindex. Wanneer u een bestaande alias bijwerkt, wordt de volledige definitie vervangen door de inhoud van de hoofdtekst van de aanvraag. Over het algemeen is het beste patroon voor updates om de aliasdefinitie op te halen met een GET, te wijzigen en vervolgens bij te werken met PUT.

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.

Het maximum aantal aliassen dat u kunt maken, verschilt per prijscategorie. Zie Servicelimieten voor meer informatie.

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

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

Aanvragen verzenden naar een indexalias

Aliassen kunnen worden gebruikt voor alle documentbewerkingen, waaronder query's, indexeren, suggesties en automatisch aanvullen.

Met deze query wordt de aanvraag verzonden naar my-alias, die is toegewezen aan een werkelijke index in uw zoekservice.

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

Een aliasdefinitie ophalen

Deze aanvraag retourneert een lijst met bestaande aliasobjecten op naam.

GET https://[service name].search.windows.net/aliases?api-version=[api-version]&$select=name
api-key: [admin key]

Met deze aanvraag wordt een aliasdefinitie geretourneerd

GET https://[service name].search.windows.net/aliases/my-alias?api-version=[api-version]
api-key: [admin key]

Een alias bijwerken

De meest voorkomende update van een alias is het wijzigen van de indexnaam wanneer de onderliggende index wordt vervangen door een nieuwere versie.

PUT is vereist voor aliasupdates, zoals beschreven in Create or Update Alias (REST Preview).

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

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.

Als u probeert een index te verwijderen die momenteel is toegewezen aan een alias, mislukt de bewerking met 400 (Ongeldige aanvraag) en een foutbericht waarin wordt aangegeven dat de aliassen die aan die index zijn toegewezen, moeten worden verwijderd of toegewezen aan een andere index voordat de index kan worden verwijderd.

Zie ook

  • Last updated on