Az index alias létrehozása az Azure AI Keresés-ben

Az Azure AI Keresés-ben az index álnév egy keresési index másodlagos neve. Létrehozhat egy aliast, amely leképeződik egy keresési indexre, és helyettesítheti az aliasnevet olyan helyeken, ahol egyébként hivatkozhat egy indexnévre. Ez a funkció rugalmasságot biztosít, ha módosítania kell azt az indexet, amelyre az alkalmazás rámutat. Ahelyett, hogy az élő kódban lévő indexnévre mutató hivatkozásokat frissítené, egyszerűen frissítheti az alias-leképezést.

Egy keresési szolgáltatás aliasait HTTP-kérésekkel (POST, GET, PUT vagy DELETE) hozhatja létre és kezelheti egy adott alias-erőforráson. Az aliasok szolgáltatásszintű erőforrások, amelyeket a keresési indexektől függetlenül tartanak fenn. Miután létrehozott egy keresési indexet, létrehozhat egy aliast, amely megfelelteti azt.

Az alias használata előtt az alkalmazás közvetlenül a rendszernek hotel-samples-indexküld kéréseket.

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

Az alias használata után az alkalmazás kéréseket küld a my-alias, ami a hotel-samples-index-re van leképezve.

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

Előfeltételek

• Egy Azure AI Keresés szolgáltatás bármely régióban és tarifacsomagban.
• Egy meglévő keresési index, amelyhez hozzá szeretné rendelni az aliast.
• Alias létrehozásához szükséges engedélyek:
  • Kulcsalapú hitelesítés esetén a keresési szolgáltatáshoz tartozó rendszergazdai API-kulcs .
  • Szerepköralapú hitelesítés esetén a Keresési szolgáltatás közreműködői szerepköre .

Korlátozások és szempontok

• Csak dokumentumműveleteket tartalmazó aliast használhat, vagy indexdefiníciót kérhet le és frissíthet.
• Nem használhat aliast indexek törlésére vagy szöveg jogkivonatának tesztelésére.
• Nem hivatkozhat aliasra targetIndexName vagy tudásbázisként.

Index aliasának létrehozása

Az alias létrehozása megfeleltetést hoz létre egy aliasnév és egy indexnév között. Ha a kérés sikeres, használhatja az aliast indexeléshez, lekérdezéshez és egyéb műveletekhez.

Aliast a REST API, a Azure SDK-k vagy a Azure portál használatával hozhat létre. Az alias az name aliasból és annak a keresési indexnek a nevéből áll, amelyhez az alias megfelel. A tömbben indexes csak egy indexnevet adhat meg.

A létrehozható aliasok maximális száma a tarifacsomagtól függően változik. További információ: Index aliaskorlátok.

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

// Create a SearchIndexClient
SearchIndexClient adminClient = new SearchIndexClient(serviceEndpoint, credential);

// Create an index alias
SearchAlias myAlias = new SearchAlias("my-alias", "hotel-samples-index");
adminClient.CreateAlias(myAlias);

Kérések küldése indexaliasnak

Minden dokumentumművelethez használhat aliast, beleértve a lekérdezést, az indexelést, a javaslatokat és az automatikus kiegészítést.

A következő lekérdezés elküldi a kérést a my-alias címkéhez, amely a keresési szolgáltatás tényleges indexére van leképezve.

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

Aliasdefiníció lekérése

Az Aliasok – Lista (REST API) használatával név szerint adja vissza a meglévő aliasobjektumok listáját.

GET /aliases?api-version=2026-04-01&$select=name

Az Aliasok – Get (REST API) használatával visszaadhatja egy adott alias definícióját.

GET /aliases/my-alias?api-version=2026-04-01

Alias frissítése

Az aliasok leggyakoribb frissítése az index nevének módosítása, amikor a mögöttes indexet egy újabb verzióra cserélik.

Aliasok használata – Aliasok létrehozása vagy frissítése (REST API) az aliasok frissítéséhez. Az alábbi példa bemutatja, hogyan frissítheti a my-alias-t, hogy a hotel-samples-index2 helyett a hotel-samples-index-re mutasson.

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

Egy alias frissítése akár 10 másodpercet is igénybe vehet a rendszeren keresztüli propagáláshoz, ezért várjon legalább 10 másodpercet, mielőtt törli azt az indexet, amelyre az alias korábban megfeleltetett.

Ha egy aliasra leképezett indexet próbál törölni, a művelet 400-zal (hibás kéréssel) meghiúsul, és hibaüzenet jelenik meg arról, hogy az indexhez hozzárendelt alias(ok)t törölni kell vagy egy másik indexre kell leképezni, mielőtt az index törölhető lenne.

Kapcsolódó tartalom

• Az Azure AI Keresés szolgáltatásban lévő index törlése és újraépítése