Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Uwaga
Foundry IQ (Wyszukiwanie AI platformy Azure) udostępnia bezpośrednie interfejsy API indeksowania i zapytań, a także interfejsy API wyższego poziomu dla źródeł wiedzy i baz wiedzy do zarządzanego pobierania. Użyj portalu Azure, interfejsów API REST lub Azure SDKs, aby skonfigurować te możliwości lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.
W Foundry IQ (Wyszukiwanie AI platformy Azure) parametr $select określa pola do uwzględnienia w wynikach wyszukiwania. W tym artykule opisano składnię OData $select i przedstawiono przykłady.
Konstrukcja ścieżki pola i stałe są opisane w omówieniu języka OData w narzędziu Foundry IQ. Więcej informacji na temat struktury wyników wyszukiwania znajduje się w artykule Jak pracować z wynikami wyszukiwania w Foundry IQ.
Składnia
Parametr $select określa, które pola dla każdego dokumentu są zwracane w zestawie wyników zapytania. Następujący formularz EBNF (rozszerzony formularz Backus-Naur) definiuje gramatykę dla parametru $select :
select_expression ::= '*' | field_path(',' field_path)*
field_path ::= identifier('/'identifier)*
Dostępny jest również interakcyjny diagram składni:
Uwaga
Aby uzyskać pełną składnię EBNF, zobacz dokumentację składni wyrażeń OData dla Foundry IQ.
Parametr $select jest dostępny w dwóch formach:
- Pojedyncza gwiazdka (
*), wskazująca, że wszystkie pola, które można pobrać, powinny zostać zwrócone lub - Rozdzielona przecinkami lista ścieżek pól identyfikujących pola, które powinny być zwracane.
Korzystając z drugiego formularza, można określić w liście tylko pola, które można pobrać.
Jeśli wyświetlisz pole złożone bez jawnego określenia pól podrzędnych, wszystkie pola podrzędne, które można pobrać, zostaną uwzględnione w zestawie wyników zapytania. Załóżmy na przykład, że indeks zawiera pole Address z polami podrzędnymi Street, City i Country, które są możliwe do pobrania. Jeśli określisz Addressw $select, wyniki zapytania będą zawierać wszystkie trzy pola podrzędne.
Przykłady
Uwzględnij HotelId, HotelName i Rating pola najwyższego poziomu w wynikach i uwzględnij City pole podrzędne:Address
$select=HotelId, HotelName, Rating, Address/City
Przykładowy wynik może wyglądać następująco:
{
"HotelId": "1",
"HotelName": "Stay-Kay City Hotel",
"Rating": 4,
"Address": {
"City": "New York"
}
}
Uwzględnij w wynikach pole HotelName najwyższego poziomu. Uwzględnij wszystkie pola podrzędne Address. Uwzględnij Type pola dodatkowe BaseRate każdego obiektu w kolekcji Rooms.
$select=HotelName, Address, Rooms/Type, Rooms/BaseRate
Przykładowy wynik może wyglądać następująco:
{
"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
}
]
}