Documents - Suggest Get
Sugeruje dokumenty w indeksie, które pasują do danego częściowego tekstu zapytania.
GET {endpoint}/indexes('{indexName}')/docs/search.suggest?search={search}&suggesterName={suggesterName}&api-version=2023-11-01
GET {endpoint}/indexes('{indexName}')/docs/search.suggest?search={search}&suggesterName={suggesterName}&$filter={$filter}&fuzzy={fuzzy}&highlightPostTag={highlightPostTag}&highlightPreTag={highlightPreTag}&minimumCoverage={minimumCoverage}&$orderby={$orderby}&searchFields={searchFields}&$select={$select}&$top={$top}&api-version=2023-11-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
endpoint
|
path | True |
string |
Adres URL punktu końcowego usługi wyszukiwania. |
index
|
path | True |
string |
Nazwa indeksu. |
api-version
|
query | True |
string |
Wersja interfejsu API klienta. |
search
|
query | True |
string |
Tekst wyszukiwania, który ma być używany do sugerowania dokumentów. Musi mieć co najmniej 1 znak i nie więcej niż 100 znaków. |
suggester
|
query | True |
string |
Nazwa sugestora określona w kolekcji sugestorów, która jest częścią definicji indeksu. |
$filter
|
query |
string |
Wyrażenie OData, które filtruje dokumenty rozważane pod kątem sugestii. |
|
$orderby
|
query |
string[] |
Lista wyrażeń OData $orderby, według których mają być sortowane wyniki. Każde wyrażenie może być nazwą pola lub wywołaniem funkcji geo.distance() lub search.score(). Po każdym wyrażeniu można wskazać rosnąco lub desc wskazującym malejąco. Wartość domyślna to kolejność rosnąca. Więzi zostaną przerwane przez wyniki dopasowań dokumentów. Jeśli nie określono $orderby, domyślna kolejność sortowania jest malejąco według wyniku dopasowania dokumentu. Może istnieć co najwyżej 32 klauzule $orderby. |
|
$select
|
query |
string[] |
Lista pól do pobrania. Jeśli nie zostanie określona, tylko pole klucza zostanie uwzględnione w wynikach. |
|
$top
|
query |
integer int32 |
Liczba sugestii do pobrania. Wartość musi być liczbą z zakresu od 1 do 100. Wartość domyślna to 5. |
|
fuzzy
|
query |
boolean |
Wartość wskazująca, czy używać dopasowywania rozmytego dla zapytania sugestii. Wartość domyślna to false. Po ustawieniu wartości true zapytanie znajdzie terminy, nawet jeśli w tekście wyszukiwania znajduje się znak zastępczy lub brakuje go. Chociaż zapewnia to lepsze środowisko w niektórych scenariuszach, wiąże się to z kosztem wydajności, ponieważ sugestie rozmyte są wolniejsze i zużywają więcej zasobów. |
|
highlight
|
query |
string |
Tag ciągu, który jest dołączany do wyróżniania trafień. Należy ustawić element z elementem highlightPreTag. Jeśli pominięto, wyróżnienie trafień sugestii jest wyłączone. |
|
highlight
|
query |
string |
Tag ciągu, który jest poprzedzany wyróżniania trafień. Należy ustawić element z elementem highlightPostTag. Jeśli pominięto, wyróżnienie trafień sugestii jest wyłączone. |
|
minimum
|
query |
number double |
Liczba z zakresu od 0 do 100 wskazująca wartość procentową indeksu, która musi być objęta sugestiami w celu zgłoszenia zapytania jako powodzenia. Ten parametr może być przydatny do zapewnienia dostępności wyszukiwania nawet dla usług z tylko jedną repliką. Wartość domyślna to 80. |
|
search
|
query |
string[] |
Lista nazw pól do wyszukiwania określonego tekstu wyszukiwania. Pola docelowe muszą być uwzględnione w określonym sugestorze. |
Nagłówek żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
x-ms-client-request-id |
string uuid |
Identyfikator śledzenia wysłany z żądaniem, aby ułatwić debugowanie. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Odpowiedź zawierająca sugerowane dokumenty zgodne z częściowymi danymi wejściowymi. |
|
Other Status Codes |
Odpowiedź na błąd. |
Przykłady
SearchIndexSuggestDocumentsGet
Sample Request
GET https://myservice.search.windows.net/indexes('myindex')/docs/search.suggest?search=hote&suggesterName=sg&$filter=rating gt 10&fuzzy=False&highlightPostTag=</em>&highlightPreTag=<em>&minimumCoverage=80&$orderby=search.score() desc,rating desc&searchFields=title&$select=docId,title,description&$top=10&api-version=2023-11-01
Sample Response
{
"value": [
{
"@search.text": "Nice <em>Hotel</em>",
"description": "Cheapest hotel in town",
"docId": "1",
"title": "Nice Hotel"
},
{
"@search.text": "Fancy <em>Hotel</em>",
"description": "Best hotel in town",
"docId": "2",
"title": "Fancy Hotel"
}
]
}
Definicje
Nazwa | Opis |
---|---|
Search |
Opisuje warunek błędu dla interfejsu API. |
Suggest |
Odpowiedź zawierająca wyniki zapytania sugestii z indeksu. |
Suggest |
Wynik zawierający dokument znaleziony przez zapytanie sugestii oraz skojarzone metadane. |
SearchError
Opisuje warunek błędu dla interfejsu API.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Jeden z zdefiniowanych przez serwer zestaw kodów błędów. |
details |
Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu. |
|
message |
string |
Czytelna dla człowieka reprezentacja błędu. |
SuggestDocumentsResult
Odpowiedź zawierająca wyniki zapytania sugestii z indeksu.
Nazwa | Typ | Opis |
---|---|---|
@search.coverage |
number |
Wartość wskazująca wartość procentową indeksu, który został uwzględniony w zapytaniu, lub wartość null, jeśli w żądaniu nie ustawiono wartości minimalnejCoverage. |
value |
Sekwencja wyników zwróconych przez zapytanie. |
SuggestResult
Wynik zawierający dokument znaleziony przez zapytanie sugestii oraz skojarzone metadane.
Nazwa | Typ | Opis |
---|---|---|
@search.text |
string |
Tekst wyniku sugestii. |