Index aliasának létrehozása az Azure AI Searchben

Fontos

Az index-aliasok jelenleg nyilvános előzetes verzióban érhetők el, és kiegészítő használati feltételek mellett érhetők el.

Az Azure AI Searchben az index aliasa egy másodlagos név, amely lekérdezési, indexelési és egyéb műveletek indexére hivatkozhat. Létrehozhat egy aliast, amely megfelel egy keresési indexnek, és helyettesítheti az aliasnevet olyan helyeken, ahol egyébként hivatkozna egy indexnévre. Az aliasok rugalmasságot biztosítanak, ha módosítania kell, hogy az alkalmazás melyik indexre mutat. Az alkalmazás hivatkozásainak frissítése helyett egyszerűen frissítheti az alias leképezését.

Az index-aliasok fő célja az éles indexek könnyebb kezelése. Ha például módosítania kell az indexdefiníciót, például egy mező szerkesztését vagy egy új elemző hozzáadását, létre kell hoznia egy új keresési indexet, mert az összes keresési index nem módosítható. Ez azt jelenti, hogy vagy le kell dobnia és újra kell építenie az indexet , vagy létre kell hoznia egy új indexet, majd át kell telepítenie az alkalmazást az adott indexbe.

Az index elvetése és újraépítése helyett használhat index aliasokat. Egy tipikus munkafolyamat a következő:

1. Keresési index létrehozása
2. Alias létrehozása, amely megfelel a keresési indexnek
3. Kérje meg az alkalmazást, hogy az index neve helyett küldjön lekérdezési/indexelési kéréseket az aliasnak
4. Ha újraépítést igénylő módosítást kell végeznie az indexen, hozzon létre egy új keresési indexet
5. Ha az új index készen áll az indulásra, frissítse az aliast az új indexre való leképezéshez, és a kérések automatikusan az új indexhez lesznek irányítva

Indexalias létrehozása

Aliast az előzetes REST API-val, az előzetes verziójú SDK-kkal vagy az Azure Portalon hozhat létre. Az alias az name aliasból és annak a keresési indexnek a nevéből áll, amellyel az alias megfeleltethető. A tömbben indexes csak egy indexnév adható meg.

REST API

Az index aliasának létrehozásához használhatja az Alias létrehozása vagy frissítése (REST előzetes verzió) lehetőséget.

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

Azure Portalra

Az alábbi lépéseket követve hozzon létre index aliast az Azure Portalon.

1. Lépjen a keresési szolgáltatáshoz az Azure Portalon.
2. Keresse meg és válassza az Aliasok lehetőséget.
3. Válassza az + Alias hozzáadása lehetőséget.
4. Adjon nevet az index aliasának, és válassza ki azt a keresési indexet, amelyhez le szeretné képezni az aliast. Ezt követően válassza a Mentés lehetőséget.

.NET SDK

A .NET-hez készült Azure SDK bétacsomagjainak egyikével az alábbi szintaxissal hozhat létre index aliast.

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

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

Az index-aliasok a Legújabb előzetes verziójú Java, Python és JavaScript SDK-kban is támogatottak.

Kérések küldése indexaliasnak

Miután létrehozta az aliast, készen áll a használatára. Az aliasok az összes dokumentumművelethez használhatók, beleértve a lekérdezést, az indexelést, a javaslatokat és az automatikus kiegészítést.

Az alábbi lekérdezésben ahelyett, hogy elküldené a kérést hotel-samples-index, elküldheti a kérést my-alias , és ennek megfelelően irányítja.

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
}

Ha várhatóan frissít egy éles indexet, adjon meg egy aliast az ügyféloldali alkalmazásban az index neve helyett. Az index-újraépítést igénylő forgatókönyveket a Drop és az index újraépítése című témakörben ismertetjük.

Feljegyzés

Csak dokumentumműveleteket tartalmazó aliast használhat, vagy indexdefiníciót kérhet le és frissíthet. Az aliasok nem használhatók index törlésére, nem használhatók a Szövegelemzés API-val, és nem használhatók indexelőként targetIndexName .

Az aliasok frissítése akár 10 másodpercet is igénybe vehet a rendszeren keresztüli propagáláshoz, ezért legalább 10 másodpercet kell várnia, mielőtt elvégezne minden olyan műveletet az indexben, amelyet leképeztek vagy nemrégiben leképeztek az aliasra.

Indexek felcserélése

Most, amikor frissítenie kell az alkalmazást, hogy egy új indexre mutasson, mindössze annyit kell tennie, hogy frissíti az alias leképezését. A PUT a létrehozási vagy frissítési aliasban (REST előzetes verzió) leírt frissítésekhez szükséges.

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

Miután frissítette az aliast, a kérések automatikusan az új indexhez lesznek irányítva.

Feljegyzés

Az aliasok frissítése akár 10 másodpercet is igénybe vehet a rendszeren keresztüli propagáláshoz, ezért legalább 10 másodpercet kell várnia az alias által korábban leképezett index törlése előtt.

Lásd még

• Index elvetése és újraépítése az Azure AI Searchben