Tworzenie aliasu indeksu w Wyszukiwanie AI platformy Azure

Note

Wyszukiwanie AI platformy Azure jest dostępna za pośrednictwem portalu Azure, interfejsów API REST i Azure SDKs. Jest także podstawą Foundry IQ — zarządzanej warstwy wiedzy, która przekształca treści przedsiębiorstwa w bazy wiedzy wielokrotnego użytku z uwzględnieniem uprawnień dla agentów w portalu Microsoft Foundry.

W Wyszukiwanie AI platformy Azure alias indeksu jest nazwą pomocniczą indeksu wyszukiwania. Możesz utworzyć alias odnoszący się do indeksu wyszukiwania i użyć jego nazwy tam, gdzie normalnie odwołujesz się do nazwy indeksu. Ta funkcja zapewnia elastyczność, jeśli musisz zmienić indeks, na który wskazuje aplikacja. Zamiast aktualizować odwołania do nazwy indeksu w kodzie produkcyjnym, można po prostu zaktualizować mapowanie aliasów.

Aliasy w usłudze wyszukiwania można tworzyć i zarządzać nimi za pośrednictwem żądań HTTP (POST, GET, PUT lub DELETE) względem danego zasobu aliasu. Aliasy to zasoby na poziomie usługi, które są obsługiwane niezależnie od indeksów wyszukiwania. Po utworzeniu indeksu wyszukiwania można utworzyć alias mapujący go.

Przed użyciem aliasu aplikacja wysyła żądania bezpośrednio do 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 użyciu aliasu aplikacja wysyła żądania do my-aliaselementu , które mapuje 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
}

Wymagania wstępne

• Usługa Wyszukiwanie AI platformy Azure w dowolnym regionie i warstwie cenowej.
• Istniejący indeks wyszukiwania , do którego chcesz mapować alias.
• Uprawnienia do tworzenia aliasu:
  • W przypadku uwierzytelniania opartego na kluczach klucz interfejsu API administratora dla usługi wyszukiwania.
  • W przypadku uwierzytelniania opartego na rolach rola Współtwórca usługi wyszukiwania.

Ograniczenia i zagadnienia

• Możesz używać aliasu tylko z operacjami dokumentów albo aby pobrać i zaktualizować definicję indeksu.
• Nie można użyć aliasu do usunięcia indeksu ani przetestowania tokenizacji tekstu.
• Nie można odwołać się do aliasu w targetIndexNameindeksatorze lub źródle wiedzy.

Tworzenie aliasu indeksu

Tworzenie aliasu ustanawia mapowanie między nazwą aliasu a nazwą indeksu. Jeśli żądanie zakończy się pomyślnie, możesz użyć aliasu do indeksowania, wykonywania zapytań i innych operacji.

Alias można utworzyć przy użyciu interfejsu API REST, Azure SDKs lub portalu Azure. Alias składa się z name oraz nazwy indeksu wyszukiwania, z którym alias jest powiązany. W tablicy można określić tylko jedną nazwę indeksu indexes .

Maksymalna liczba aliasów, które można utworzyć, różni się w zależności od warstwy cenowej. Aby uzyskać więcej informacji, zobacz Limity aliasów indeksu.

API REST

Użyj najnowszej stabilnej wersji Aliases - Create (REST API), aby utworzyć alias indeksu.

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

Azure SDKs

Aliasy indeksów są obsługiwane w najnowszej stabilnej wersji pakietów SDK platformy Azure dla .NET, Java, JavaScript i Python.

W poniższym przykładzie pokazano, jak utworzyć alias z Azure SDK dla .NET.

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

Portal Azure

1. Przejdź do usługi wyszukiwania w portalu Azure.

2. W okienku po lewej stronie wybierz pozycję Zarządzanie wyszukiwaniem>Aliasy.

3. Wybierz pozycję Dodaj alias.

4. Wprowadź nazwę aliasu indeksu.

5. Wybierz indeks wyszukiwania, do którego chcesz zamapować alias.

6. Wybierz pozycję Zapisz.

   

Wysyłanie żądań do aliasu indeksu

Możesz użyć aliasu dla wszystkich operacji dokumentów, w tym zapytań, indeksowania, sugestii i autouzupełniania.

Następujące zapytanie wysyła żądanie do my-alias, które zostało zamapowane na rzeczywisty indeks usługi wyszukiwania.

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
}

Pobieranie definicji aliasu

Użyj aliasów — lista (interfejs API REST), aby zwrócić listę istniejących obiektów aliasu według nazwy.

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

Użyj Aliasów — Pobierz (interfejs API REST), aby zwrócić definicję określonego aliasu.

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

Aktualizowanie aliasu

Najczęstszą aktualizacją aliasu jest zmiana nazwy indeksu, gdy podstawowy indeks zostaje zastąpiony jego nowszą wersją.

Użyj aliasów — utwórz lub zaktualizuj (interfejs API REST), aby zaktualizować alias. W poniższym przykładzie pokazano, jak zaktualizować my-alias tak, aby wskazywał na hotel-samples-index2 zamiast hotel-samples-index.

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

Propagacja aktualizacji aliasu przez system może potrwać do 10 sekund, więc poczekaj co najmniej 10 sekund przed usunięciem indeksu, do którego alias został wcześniej zamapowany.

Jeśli próbujesz usunąć indeks, który jest obecnie mapowany na alias, operacja zakończy się niepowodzeniem z błędem 400 (Nieprawidłowe żądanie) i komunikatem o błędzie z informacją, że alias (es) zamapowany na ten indeks musi zostać usunięty lub zamapowany na inny indeks przed usunięciem indeksu.

Powiązana zawartość

• Upuść i odbuduj indeks w Wyszukiwanie AI platformy Azure