Vytvoření aliasu indexu v Azure AI Vyhledávač

V Azure AI Vyhledávač je alias indexu sekundárním názvem indexu vyhledávání. Můžete vytvořit alias, který se mapuje na index vyhledávání, a použít tento název aliasu na místech, kde byste jinak odkazovali na název indexu. Tato funkce poskytuje flexibilitu, pokud potřebujete změnit index, na který aplikace odkazuje. Místo aktualizace odkazů na název indexu v produkčním kódu můžete mapování aliasů jednoduše aktualizovat.

Aliasy ve vyhledávací službě můžete vytvářet a spravovat prostřednictvím požadavků HTTP (POST, GET, PUT nebo DELETE) u daného prostředku aliasu. Aliasy jsou prostředky na úrovni služby, které se spravují nezávisle na indexech vyhledávání. Po vytvoření indexu vyhledávání můžete vytvořit alias, který k němu mapuje.

Před použitím aliasu vaše aplikace odesílá žádosti přímo na hotel-samples-index.

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

Po použití aliasu aplikace odešle požadavky na my-alias, které se mapují na hotel-samples-index.

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

Požadavky

• Služba Azure AI Vyhledávač v libovolné oblasti a cenové úrovni.
• Existující index vyhledávání , na který chcete namapovat alias.
• Oprávnění k vytvoření aliasu:
  • Pro ověřování založené na klíčích klíč rozhraní API pro správu pro vaši vyhledávací službu.
  • Pro ověřování založené na rolích je role Přispěvatel vyhledávací služby.

Omezení a důležité informace

• Alias můžete použít pouze s operacemi dokumentu nebo získat a aktualizovat definici indexu.
• Alias nemůžete použít k odstranění indexu nebo testování tokenizace textu.
• Nemůžete odkazovat na alias jako na targetIndexName u indexeru nebo zdroje znalostí.

Vytvoření aliasu indexu

Vytvoření aliasu vytvoří mapování mezi názvem aliasu a názvem indexu. Pokud je požadavek úspěšný, můžete použít alias pro indexování, dotazování a další operace.

Alias můžete vytvořit pomocí rozhraní REST API, Sady Azure SDK nebo portálu Azure. Alias se skládá z name aliasu a názvu indexu vyhledávání, na který se alias mapuje. V poli můžete zadat pouze jeden název indexu indexes .

Maximální počet aliasů, které můžete vytvořit, se liší podle cenové úrovně. Další informace najdete v tématu Omezení aliasů indexu.

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);

Odeslat požadavky na alias indexu

Alias můžete použít pro všechny operace s dokumentem, včetně dotazování, indexování, návrhů a automatického dokončování.

Následující dotaz odesílá požadavek my-alias, který je namapován do skutečného indexu ve vyhledávací službě.

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
}

Získání definice aliasu

Pomocí aliasů – List (REST API) vrátíte seznam existujících objektů aliasů podle názvu.

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

Pomocí aliasů – Get (REST API) vrátíte definici konkrétního aliasu.

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

Aktualizace aliasu

Nejběžnější aktualizací aliasu je změna názvu indexu, když je podkladový index nahrazen novější verzí.

K aktualizaci aliasu použijte aliasy – Vytvoření nebo aktualizace (REST API). Následující příklad ukazuje, jak aktualizovat my-alias odkaz na hotel-samples-index2 místo hotel-samples-index.

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

Aktualizace aliasu může v systému zabrat až 10 sekund, takže počkejte alespoň 10 sekund, než odstraníte index, na který byl alias dříve mapován.

Pokud se pokusíte odstranit index, který je aktuálně namapovaný na alias, operace selže s chybou 400 (Chybný požadavek) a chybovou zprávou s oznámením, že aliasy mapované na tento index musí být odstraněny nebo namapovány na jiný index, aby bylo možné index odstranit.

Související obsah

• Odstranění a opětovné sestavení indexu v Azure AI Vyhledávač