Documents - Suggest Get

Služba:: Search Service

Verze rozhraní API:: 2025-09-01

Navrhne dokumenty v indexu, které odpovídají danému částečnému textu dotazu.

GET {endpoint}/indexes('{indexName}')/docs/search.suggest?search={search}&suggesterName={suggesterName}&api-version=2025-09-01

S volitelnými parametry:

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=2025-09-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string	Adresa URL koncového bodu vyhledávací služby.
indexName	path	True	string	Název indexu.
api-version	query	True	string	Verze rozhraní API klienta.
search	query	True	string	Hledaný text, který se má použít k navrhování dokumentů. Musí mít alespoň 1 znak a ne více než 100 znaků.
suggesterName	query	True	string	Název modulu pro návrhy, jak je uvedeno v kolekci pro návrhy
$filter	query		string	Výraz OData, který filtruje dokumenty zvažované pro návrhy.
$orderby	query		string[]	Seznam výrazů OData $orderby, podle kterých se mají výsledky seřadit. Každý výraz může být buď názvem pole, nebo voláním funkcí geo.distance() nebo search.score(). Za každým výrazem může následovat asc pro označení vzestupného výrazu nebo desc pro označení sestupného. Výchozí je vzestupné pořadí. Nerozhodné výsledky budou přerušeny skóre shody v dokumentech. Pokud není zadána žádná $orderby, výchozí pořadí řazení je sestupné podle skóre shody dokumentu. Může existovat maximálně 32 $orderby klauzulí.
$select	query		string[]	Seznam polí, která se mají načíst. Pokud není zadáno, bude do výsledků zahrnuto pouze klíčové pole.
$top	query		integer (int32)	Počet návrhů k načtení. Hodnota musí být číslo mezi 1 a 100. Výchozí hodnota je 5.
fuzzy	query		boolean	Hodnota označující, zda se má použít přibližná shoda pro dotaz na návrhy. Výchozí hodnota je False. Pokud je nastavená hodnota true, dotaz najde výrazy i v případě, že ve vyhledávaném textu je nahrazený nebo chybějící znak. I když to v některých scénářích poskytuje lepší prostředí, přichází to za cenu výkonu, protože dotazy přibližných návrhů jsou pomalejší a spotřebovávají více prostředků.
highlightPostTag	query		string	Značka řetězce, která je připojena ke zvýraznění polí. Musí být nastaveno pomocí highlightPreTag. Pokud je vynechán, zvýraznění návrhů je zakázáno.
highlightPreTag	query		string	Značka řetězce, která je předřazena tak, aby dosáhla na světla. Musí být nastaveno pomocí highlightPostTag. Pokud je vynechán, zvýraznění návrhů je zakázáno.
minimumCoverage	query		number (double)	Číslo mezi 0 a 100 označující procento indexu, které musí být pokryto dotazem na návrhy, aby byl dotaz hlášen jako úspěšný. Tento parametr může být užitečný pro zajištění dostupnosti vyhledávání i pro služby s pouze jednou replikou. Výchozí hodnota je 80.
searchFields	query		string[]	Seznam názvů polí pro vyhledání zadaného hledaného textu. Cílová pole musí být zahrnuta v určeném modulu pro návrhy.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
x-ms-client-request-id		string (uuid)	ID sledování odeslané s požadavkem na pomoc s laděním.

Odpovědi

Name	Typ	Description
200 OK	SuggestDocumentsResult	Odpověď obsahující navrhované dokumenty, které odpovídají částečnému vstupu.
Other Status Codes	ErrorResponse	Chybová odpověď.

Příklady

SearchIndexSuggestDocumentsGet

Ukázkový požadavek

HTTP

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=2025-09-01

Ukázková odpověď

Stavový kód:: 200

{
  "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"
    }
  ]
}

Definice

Name	Description
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
SuggestDocumentsResult	Odpověď obsahující dotaz na návrh je výsledkem indexu.
SuggestResult	Výsledek obsahující dokument nalezený dotazem na návrh a přidružená metadata.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

SuggestDocumentsResult

Objekt

Odpověď obsahující dotaz na návrh je výsledkem indexu.

Name	Typ	Description
@search.coverage	number (double)	Hodnota označující procento indexu, který byl zahrnut do dotazu, nebo null, pokud v požadavku nebylo nastaveno minimumCoverage.
value	SuggestResult[]	Posloupnost výsledků vrácených dotazem.

SuggestResult

Objekt

Výsledek obsahující dokument nalezený dotazem na návrh a přidružená metadata.

Name	Typ	Description
@search.text	string	Text výsledku návrhu.