Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In dieser Schnellstartanleitung erstellen Sie Ihren ersten Azure AI Search-Index mithilfe des Assistenten zum Importieren von Daten und einem integrierten Beispiel für fiktive Hoteldaten, die von Microsoft gehostet werden. Der Assistent erfordert keinen Code zum Erstellen eines Indexes und hilft Ihnen dabei, interessante Abfragen innerhalb von Minuten zu schreiben.
Der Assistent erstellt mehrere Objekte in Ihrem Suchdienst, einschließlich eines durchsuchbaren Indexes, eines Indexers und einer Datenquellenverbindung für den automatisierten Datenabruf. Am Ende dieser Schnellstartanleitung überprüfen wir die einzelnen Objekte.
Hinweis
Der Assistent zum Importieren von Daten umfasst Optionen für OCR, Textübersetzung und andere KI-Anreicherungen, die in dieser Schnellstartanleitung nicht behandelt werden. Eine ähnliche exemplarische Vorgehensweise mit dem Schwerpunkt KI-Anreicherung finden Sie unter Schnellstart: Erstellen eines Skillsets im Azure-Portal.
Voraussetzungen
Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
Ein Azure AI Search-Dienst. Erstellen Sie einen Dienst , oder suchen Sie einen vorhandenen Dienst in Ihrem aktuellen Abonnement. Für diesen Schnellstart können Sie einen kostenlosen Dienst verwenden.
Vertrautheit mit dem Assistenten. Siehe Importieren von Daten-Assistenten im Azure-Portal.
Überprüfen des Netzwerkzugriffs
Stellen Sie für diese Schnellstartanleitung, die integrierte Beispieldaten verwendet, sicher, dass Ihr Suchdienst keine Netzwerkzugriffssteuerungen hat. Der Azure-Portalcontroller verwendet einen öffentlichen Endpunkt, um Daten und Metadaten aus der von Microsoft gehosteten Datenquelle abzurufen. Weitere Informationen finden Sie unter Sichere Verbindungen in den Import-Assistenten.
Überprüfen des Speicherplatzes
Viele Kunden beginnen mit einem kostenlosen Suchdienst, der auf drei Indizes, drei Indexer und drei Datenquellen beschränkt ist. Diese Schnellstartanleitung erstellt eine der einzelnen Objekte. Bevor Sie beginnen, stellen Sie sicher, dass Sie Platz für zusätzliche Objekte haben.
Wählen Sie auf der Registerkarte "Übersicht " die Option "Verwendung " aus, um zu sehen, über wie viele Indizes, Indexer und Datenquellen Sie derzeit verfügen.
Starten des Assistenten
Melden Sie sich beim Azure-Portal an.
Wechseln Sie zu Ihrem Suchdienst.
Wählen Sie auf der Registerkarte " Übersicht " die Option "Daten importieren " aus, um den Assistenten zu starten.
Erstellen und Laden eines Suchindexes
In diesem Abschnitt erstellen und laden Sie einen Index in vier Schritten:
- Herstellen einer Verbindung mit einer Datenquelle
- Überspringen der Konfiguration für kognitive Fähigkeiten
- Konfigurieren des Indexes
- Konfigurieren und Ausführen des Indexers
Mit einer Datenquelle verbinden
Der Assistent erstellt eine Datenquellenverbindung zu Beispieldaten, die Microsoft in Azure Cosmos DB hostet. Auf die Beispieldaten wird über einen öffentlichen Endpunkt zugegriffen, daher benötigen Sie kein Azure Cosmos DB-Konto oder Quelldateien für diesen Schritt.
So stellen Sie eine Verbindung mit den Beispieldaten her:
Erweitern Sie unter Mit Ihren Daten verbinden die Dropdownliste Datenquelle, und wählen Sie Beispiele aus.
Wählen Sie hotels-sample von der Liste der integrierten Beispiele.
Wählen Sie Weiter: Kognitive Skills hinzufügen (Optional) aus, um den Vorgang fortzusetzen.
Überspringen der Konfiguration für kognitive Skills
Obwohl der Assistent die Erstellung von Skillset und KI-Anreicherung während der Indizierung unterstützt, liegen kognitive Fähigkeiten außerhalb dieses Schnellstarts.
So überspringen Sie diesen Schritt im Assistenten:
Ignorieren Sie bei Kognitive Fähigkeiten hinzufügen die KI-Anreicherungskonfigurationsoptionen.
Wählen Sie "Weiter" aus: Passen Sie den Zielindex an, um den Vorgang fortzusetzen.
Tipp
Informationen zu den ersten Schritten mit der KI-Anreicherung finden Sie in der Schnellstartanleitung: Erstellen eines Skillsets im Azure-Portal.
Konfigurieren des Index
Der Assistent leitet ein Schema für den Hotelsbeispielindex ab. So konfigurieren Sie den Index:
Akzeptieren Sie die vom System generierten Werte für den Indexnamen (hotels-sample-index) und Key (HotelId).
Übernehmen Sie die vom System generierten Werte für alle Feldattribute.
Wählen Sie Weiter: Indexer erstellen aus, um den Vorgang fortzusetzen.
Der Suchindex erfordert mindestens einen Namen und eine Sammlung von Feldern. Der Assistent sucht nach eindeutigen Zeichenfolgenfeldern und kennzeichnet eines als Dokumentschlüssel, der jedes Dokument im Index eindeutig identifiziert.
Jedes Feld weist einen Namen, einen Datentyp und Attribute auf, die steuern, wie das Feld im Index verwendet wird. Verwenden Sie die Kontrollkästchen, um die folgenden Attribute zu aktivieren oder zu deaktivieren:
Merkmal | BESCHREIBUNG | Anwendbare Datentypen |
---|---|---|
Abrufbar | In einer Abfrageantwort zurückgegebene Felder. | Zeichenfolgen und ganze Zahlen |
Filterbar | Felder, die einen Filterausdruck akzeptieren. | Ganze Zahlen |
Sortierbar | Felder, die einen Orderby-Ausdruck akzeptieren. | Ganze Zahlen |
In Facets einteilbar | Felder, die in einer faceted Navigationsstruktur verwendet werden. | Ganze Zahlen |
Durchsuchbar | Felder, die in der Volltextsuche verwendet werden. Zeichenfolgen sind durchsuchbar, aber numerische und boolesche Felder werden häufig als nicht durchsuchbar markiert. | Streichinstrumente |
Attribute wirken sich auf die Speicherung auf unterschiedliche Weise aus. Filterbare Felder verbrauchen z. B. zusätzlichen Speicher, während abrufbare Felder nicht vorhanden sind. Weitere Informationen finden Sie unter Beispiel zur Veranschaulichung der Auswirkungen von Attributen und Suggestoren auf die Speicherung.
Geben Sie Sprachanalysen oder Vorschlagsfunktionen an, wenn Sie Abfragen mit AutoVervollständigen oder vorgeschlagene Abfragen verwenden möchten.
Konfigurieren und Ausführen des Indexers
Schließlich konfigurieren und führen Sie den Indexer aus, der einen ausführbaren Prozess definiert. Die Datenquelle und der Index werden auch in diesem Schritt erstellt.
So konfigurieren und führen Sie den Indexer aus:
Übernehmen Sie den vom System generierten Wert für Indexername (hotels-sample-indexer).
Verwenden Sie für diese Schnellstartanleitung die Standardoption, um den Indexer sofort und nur einmal auszuführen. Die Beispieldaten sind statisch, sodass Sie die Änderungsnachverfolgung nicht aktivieren können.
Wählen Sie "Absenden" aus, um den Indexer gleichzeitig zu erstellen und auszuführen.
Überwachen des Indexersstatus
Sie können die Erstellung des Indexers und des Indexes im Azure-Portal überwachen. Die Registerkarte "Übersicht " enthält Links zu den Ressourcen, die in Ihrem Suchdienst erstellt wurden.
So überwachen Sie den Fortschritt des Indexers:
Wechseln Sie im Azure-Portal zu Ihrem Suchdienst.
Wählen Sie im linken Bereich die Option "Indexer" aus.
Es kann einige Minuten dauern, bis die Ergebnisse aktualisiert werden. Der neu erstellte Indexer sollte mit dem Status " In Bearbeitung " oder "Erfolg" angezeigt werden. Die Liste zeigt auch die Anzahl der indizierten Dokumente an.
Überprüfen der Suchindexergebnisse
Wechseln Sie im Azure-Portal zu Ihrem Suchdienst.
Wählen Sie im linken Bereich " Indizes" aus.
Wählen Sie hotels-sample-index aus. Wenn der Index über null Dokumente oder Speicher verfügt, warten Sie, bis das Azure-Portal aktualisiert wird.
Wählen Sie die Registerkarte Felder aus, um das Indexschema anzuzeigen.
Überprüfen Sie, welche Felder gefiltert oder sortiert werden können, damit Sie wissen, welche Abfragen geschrieben werden sollen.
Hinzufügen oder Ändern von Feldern
Auf der Registerkarte "Felder " können Sie ein Feld erstellen, indem Sie "Feld hinzufügen" auswählen und einen Namen, unterstützten Datentyp und Attribute angeben.
Das Ändern vorhandener Felder ist schwieriger. Vorhandene Felder weisen eine physische Darstellung im Suchindex auf, sodass sie nicht auch im Code geändert werden können. Um ein vorhandenes Feld grundlegend zu ändern, müssen Sie ein neues Feld erstellen, um das Original zu ersetzen. Sie können einem Index jederzeit weitere Konstrukte hinzufügen, z. B. Bewertungsprofile und CORS-Optionen.
Überprüfen Sie die Indexdefinitionsoptionen, um zu verstehen, was Sie während des Indexentwurfs nicht bearbeiten können. Wenn eine Option abgeblendet angezeigt wird, können Sie sie nicht ändern oder löschen.
Abfragen mit Suchexplorer
Sie verfügen jetzt über einen Suchindex, der mithilfe des Such-Explorers abgefragt werden kann, wodurch REST-Aufrufe gesendet werden, die der SEARCH POST REST-API entsprechen. Dieses Tool unterstützt einfache Abfragesyntax und vollständige Lucene-Abfragesyntax.
So fragen Sie Ihren Suchindex ab:
Geben Sie auf der Registerkarte Such-Explorer Text ein, nach dem gesucht werden soll.
Um zu nichtvisiblen Bereichen der Ausgabe zu springen, verwenden Sie die Minikarte.
Wechseln Sie zum Angeben der Syntax zur JSON-Ansicht.
Beispielabfragen für Hotels-Beispielindex
In den folgenden Beispielen wird die JSON-Ansicht und die REST-API-Version 2024-05-01-preview vorausgesetzt.
Tipp
Die JSON-Ansicht unterstützt IntelliSense für den Abschluss des Parameternamens. Platzieren Sie den Cursor in der JSON-Ansicht, und geben Sie ein Leerzeichen ein, um eine Liste aller Abfrageparameter anzuzeigen. Sie können auch einen Buchstaben wie "s" eingeben, um nur die Abfrageparameter anzuzeigen, die mit diesem Buchstaben beginnen. IntelliSense schließt ungültige Parameter nicht aus, verwenden Sie daher Ihr bestes Urteil.
Filterbeispiele
Parkplatz, Kategorien, Renovierungsdatum, Bewertung und Ort sind filterbar.
{
"search": "beach OR spa",
"select": "HotelId, HotelName, Description, Rating",
"count": true,
"top": 10,
"filter": "Rating gt 4"
}
Boolesche Filter gehen standardmäßig von „true“ aus.
{
"search": "beach OR spa",
"select": "HotelId, HotelName, Description, Rating",
"count": true,
"top": 10,
"filter": "ParkingIncluded"
}
Geospatialsuche ist filterbasiert. Die Funktion geo.distance
filtert alle Ergebnisse basierend auf den angegebenen Location
- und geography'POINT
-Koordinaten nach Positionsdaten. Die Abfrage sucht Hotels innerhalb von fünf Kilometern der Breiten- und Längengradkoordinaten -122.12 47.67
, die "Redmond, Washington, USA" lautet. Die Abfrage zeigt die Gesamtanzahl der Übereinstimmungen &$count=true
mit den Hotelnamen und Adressstandorten an.
{
"search": "*",
"select": "HotelName, Address/City, Address/StateProvince",
"count": true,
"top": 10,
"filter": "geo.distance(Location, geography'POINT(-122.12 47.67)') le 5"
}
Vollständige Lucene-Syntaxbeispiele
Die Standardsyntax ist eine einfache Syntax, aber wenn Sie Fuzzy-Suche, Ausdruckserstreckung oder reguläre Ausdrücke verwenden möchten, geben Sie die vollständige Syntax an.
{
"queryType": "full",
"search": "seatle~",
"select": "HotelId, HotelName,Address/City, Address/StateProvince",
"count": true
}
Falsch geschriebene Abfragebegriffe, wie z.B. seatle
anstelle von Seattle
, führen in einer typischen Suche zu keinen Übereinstimmungen. Der queryType=full
Parameter ruft den vollständigen Lucene-Abfrageparser auf, der den Tilde -Operanden (~
) unterstützt. Wenn Sie diese Parameter verwenden, führt die Abfrage eine Fuzzysuche nach dem angegebenen Schlüsselwort aus und stimmt mit Ausdrücken überein, die ähnlich sind, aber keine genaue Übereinstimmung.
Nehmen Sie sich eine Minute Zeit, um diese Beispielabfragen für Ihren Index zu testen. Weitere Informationen zu Abfragen finden Sie unter Abfragen in Azure KI-Suche.
Bereinigen von Ressourcen
Wenn Sie in Ihrem eigenen Abonnement arbeiten, sollten Sie sich am Ende eines Projekts überlegen, ob Sie die erstellten Ressourcen noch benötigen. Ressourcen, die weiterhin ausgeführt werden, können Sie Geld kosten. Sie können einzelne Ressourcen oder die gesamte Ressourcengruppe mit allen darin enthaltenen Ressourcen löschen.
Im Azure-Portal finden und verwalten Sie Ressourcen für Ihren Dienst unter "Alle Ressourcen " oder "Ressourcengruppen " im linken Bereich.
Hinweis
Wenn Sie einen kostenlosen Suchdienst verwenden, denken Sie daran, dass der Grenzwert drei Indizes, drei Indexer und drei Datenquellen ist. Sie können einzelne Objekte im Azure-Portal löschen, um unter dem Grenzwert zu bleiben.
Nächster Schritt
Probieren Sie einen Azure-Portal-Assistenten aus, um eine sofort einsatzbereite Web-App zu erstellen, die in einem Browser ausgeführt wird. Verwenden Sie diesen Assistenten für den kleinen Index, den Sie in dieser Schnellstartanleitung erstellt haben, oder verwenden Sie eines der integrierten Beispiel-Datasets für eine umfangreichere Sucherfahrung.