Erstellen eines Index-Alias in Azure AI Search

Wichtig

Indexaliase befinden sich derzeit in der öffentlichen Vorschau und sind unter zusätzlichen Nutzungsbedingungen verfügbar.

In Azure AI Search ist ein Index-Alias ein sekundärer Name, der verwendet werden kann, um auf einen Index für Abfragen, Indizierungen und andere Operationen zu verweisen. Sie können einen Alias erstellen, der einem Suchindex zugeordnet ist, und den Aliasnamen an Stellen ersetzen, an denen Sie sonst auf einen Indexnamen verweisen würden. Ein Alias bietet Ihnen zusätzliche Flexibilität, wenn Sie den Index ändern müssen, auf den Ihre Anwendung verweist. Anstatt die Verweise in Ihrer Anwendung zu aktualisieren, können Sie einfach die Zuordnung für Ihren Alias aktualisieren.

Das Hauptziel von Indexaliasen besteht darin, die Verwaltung Ihrer Produktionsindizes zu vereinfachen. Wenn Sie z. B. eine Änderung an der Indexdefinition vornehmen müssen, etwa das Bearbeiten eines Felds oder das Hinzufügen eines neuen Analysetools, müssen Sie einen neuen Suchindex erstellen, da alle Suchindizes unveränderlich sind. Dies bedeutet, dass Sie entweder Ihren Index löschen und neu erstellen oder einen neuen Index erstellen und dann Ihre Anwendung zu diesem Index migrieren müssen.

Anstatt den Index zu löschen und neu zu erstellen, können Sie Indexaliase verwenden. So sähe ein typischer Workflow aus:

1. Erstellen Ihres Suchindex
2. Erstellen eines Alias, der Ihrem Suchindex zugeordnet ist
3. Senden der Abfrage-/Indizierungsanforderungen Ihrer Anwendung an den Alias statt an den Indexnamen
4. Wenn Sie eine Änderung am Index vornehmen müssen, die eine Neuerstellung erfordert, erstellen Sie einen neuen Suchindex.
5. Wenn der neue Index einsatzbereit ist, aktualisieren Sie den Alias so, dass er dem neuen Index zugeordnet ist, dann werden Anforderungen automatisch an den neuen Index weitergeleitet.

Erstellen eines Indexalias

Sie können einen Alias mithilfe der Vorschau-REST-API, der Vorschau-SDKs oder über das Azure-Portal erstellen. Ein Alias besteht aus dem name des Alias und dem Namen des Suchindexes, dem der Alias zugeordnet ist. Im indexes-Array kann nur ein Indexname angegeben werden.

REST-API

Sie können den Befehl Alias erstellen oder aktualisieren (REST-Vorschau) verwenden, um einen Indexalias zu erstellen.

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

Azure portal

Gehen Sie folgendermaßen vor, um einen Indexalias im Azure-Portal zu erstellen.

1. Navigieren Sie zu Ihrem Suchdienst im Azure-Portal.
2. Suchen Sie Aliase, und wählen Sie die Option aus.
3. Wählen Sie +Alias hinzufügen aus.
4. Geben Sie Ihrem Indexalias einen Namen, und wählen Sie den Suchindex aus, dem Sie den Alias zuordnen möchten. Wählen Sie anschließend Speichern aus.

.NET SDK

Mithilfe eines der Betapakete aus dem Azure SDK für .NET können Sie die folgende Syntax verwenden, um einen Indexalias zu erstellen.

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

Indexaliasse werden auch in den neuesten Vorschau-SDKs für Java, Python und JavaScript unterstützt.

Senden von Anforderungen an einen Indexalias

Nachdem Sie Ihren Alias erstellt haben, können Sie mit seiner Verwendung beginnen. Aliase können für alle Dokumentvorgänge verwendet werden, einschließlich Abfragen, Indizierung, Vorschläge und AutoVervollständigen.

In der Abfrage unten können Sie die Anforderung an my-alias senden, anstatt sie an hotel-samples-index zu senden, und sie wird entsprechend weitergeleitet.

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
}

Wenn Sie erwarten, dass Sie einen Produktionsindex aktualisieren, geben Sie in Ihrer clientseitigen Anwendung einen Alias statt des Indexnamens an. Szenarien, die einen Indexneuaufbau erfordern, sind in Index löschen und neu aufbauen beschrieben.

Hinweis

Sie können nur einen Alias nur mit Dokumentvorgängen verwenden, oder um eine Indexdefinition abzurufen und zu aktualisieren. Aliase können nicht zum Löschen eines Indexes, nicht mit der Textanalyse-API und nicht als targetIndexName für einen Indexer verwendet werden.

Eine Aktualisierung eines Alias kann bis zu 10 Sekunden dauern, bis sie sich im System verbreitet hat. Daher sollten Sie mindestens 10 Sekunden warten, bevor Sie eine Operation in dem Index durchführen, der dem Alias zugeordnet wurde oder kürzlich zugeordnet wurde.

Austauschen von Indizes

Wenn Sie ihre Anwendung aktualisieren müssen, um auf einen neuen Index zu verweisen, müssen Sie nun lediglich die Zuordnung in Ihrem Alias aktualisieren. PUT ist für Updates erforderlich, wie unter Erstellen oder Aktualisieren eines Alias (REST-Vorschau) beschrieben.

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

Nachdem Sie das Aliasupdate erstellt haben, werden Anforderungen automatisch an den neuen Index weitergeleitet.

Hinweis

Es kann bis zu 10 Sekunden dauern, bis ein Update für einen Alias über das System erfolgt. Daher sollten Sie mindestens 10 Sekunden warten, bevor Sie den Index löschen, dem der Alias zuvor zugeordnet war.

Siehe auch

• Entfernen und Neuaufbau eines Index in Azure AI Search