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.
Hinweis
Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.
In Foundry IQ (Azure KI-Suche) gibt der parameter $select an, welche Felder in Suchergebnisse einbezogen werden sollen. Dieser Artikel beschreibt die OData-Syntax von $select und enthält Beispiele.
Feldpfadkonstruktion und -konstanten werden in der OData-Sprachübersicht in Foundry IQ beschrieben. Weitere Informationen zur Zusammensetzung von Suchergebnissen finden Sie unter How to work with search results in Foundry IQ.
Syntax
Der Parameter $select bestimmt, welche Felder für jedes Dokument im Abfrageresultset zurückgegeben werden. Die folgende erweiterte Backus-Naur-Form (EBNF) definiert die Grammatik des Parameters $select:
select_expression ::= '*' | field_path(',' field_path)*
field_path ::= identifier('/'identifier)*
Ein interaktives Syntaxdiagramm ist ebenfalls verfügbar:
Hinweis
Siehe OData-Ausdruckssyntaxreferenz für Foundry IQ für das vollständige EBNF.
Der Parameter $select ist in zwei Formen vorhanden:
- Ein einzelnes Sternchen (
*) gibt an, dass alle abrufbaren Felder zurückgegeben werden sollen. - Eine durch Trennzeichen getrennte Liste von Feldpfaden identifiziert, welche Felder zurückgegeben werden sollen.
Wenn Sie die zweite Form verwenden, können Sie nur abrufbare Felder in der Liste angeben.
Wenn Sie ein komplexes Feld auflisten, ohne seine Teilfelder explizit anzugeben, werden alle abrufbaren Teilfelder in die Ergebnismenge der Abfrage aufgenommen. Nehmen Sie zum Beispiel an, Ihr Index hat ein AddressFeld mitStreet, City, undCountry Unterfelder, die alle abrufbar sind. Wenn SieAddress in $selectangeben, enthalten die Abfrageergebnisse alle drei Teilfelder.
Beispiele
Nehmen Sie die Felder HotelId, HotelName und Rating auf oberster Ebene in die Ergebnisse auf, und nehmen Sie das City-Teilfeld von Address auf.
$select=HotelId, HotelName, Rating, Address/City
Ein Beispielergebnis könnte wie folgt aussehen:
{
"HotelId": "1",
"HotelName": "Stay-Kay City Hotel",
"Rating": 4,
"Address": {
"City": "New York"
}
}
Schließen Sie das Feld der HotelNameobersten Ebene in die Ergebnisse ein. Schließen Sie alle Teilfelder von Address. Schließen Sie dieTypeundBaseRate Unterfelder jedes Objekts in der RoomsSammlung ein:
$select=HotelName, Address, Rooms/Type, Rooms/BaseRate
Ein Beispielergebnis könnte wie folgt aussehen:
{
"HotelName": "Stay-Kay City Hotel",
"Rating": 4,
"Address": {
"StreetAddress": "677 5th Ave",
"City": "New York",
"StateProvince": "NY",
"Country": "USA",
"PostalCode": "10022"
},
"Rooms": [
{
"Type": "Budget Room",
"BaseRate": 9.69
},
{
"Type": "Budget Room",
"BaseRate": 8.09
}
]
}