Condividi tramite

Creare un alias di indice in Ricerca di intelligenza artificiale di Azure

Importante

Gli alias di indice sono attualmente disponibili in anteprima pubblica e disponibili in condizioni supplementari per l'utilizzo.

Un alias di indice in Ricerca di intelligenza artificiale di Azure è un nome alternativo per un indice. È possibile usare l'alias anziché il nome dell'indice nell'applicazione, riducendo al minimo gli aggiornamenti futuri al codice di produzione. Se è necessario passare a un indice più recente, è possibile aggiornare il mapping degli alias.

Prima di usare un alias, l'applicazione invia le richieste direttamente a hotel-samples-index.

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

Dopo aver usato un alias, l'applicazione invia richieste a my-alias, che esegue il mapping a hotel-samples-index.

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

Scenari supportati

È possibile usare un alias solo con operazioni sui documenti o per ottenere e aggiornare una definizione di indice.

Gli alias non possono essere usati per eliminare un indice o testare la tokenizzazione del testo oppure fare riferimento come in targetIndexName un indicizzatore.

Creare un alias di indice

È possibile creare un alias usando l'API REST di anteprima, gli SDK di anteprima o tramite il portale di Azure. Un alias è costituito da name dell'alias e dal nome dell'indice di ricerca a cui è mappato l'alias. Nella matrice di indexes è possibile specificare un solo nome di indice.

È possibile usare l'alias di creazione o aggiornamento (anteprima REST) per creare un alias di indice.

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

Inviare richieste a un alias di indice

Gli alias possono essere usati per tutte le operazioni sui documenti, tra cui query, indicizzazione, suggerimenti e completamento automatico.

Questa query invia la richiesta a my-alias, che viene mappata a un indice effettivo nel servizio di ricerca.

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

Aggiornare un alias

PUT è necessario per gli aggiornamenti alias, come descritto in Creare o aggiornare alias (anteprima REST).

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

Un aggiornamento di un alias può richiedere fino a 10 secondi per propagarsi nel sistema, quindi è necessario attendere almeno 10 secondi prima di eliminare l'indice a cui è stato eseguito il mapping dell'alias.

Vedi anche