Documents - Suggest Get

Referencia

Szolgáltatás:: Search Service

API-verzió:: 2024-07-01

A megadott részleges lekérdezési szövegnek megfelelő dokumentumokat javasol az indexben.

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

Opcionális paraméterekkel:

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=2024-07-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
endpoint	path	True	string	A keresési szolgáltatás végponti URL-címe.
indexName	path	True	string	Az index neve.
api-version	query	True	string	Ügyfél API-verziója.
search	query	True	string	A dokumentumok javaslatára használható keresési szöveg. Legalább 1 karakternek és legfeljebb 100 karakternek kell lennie.
suggesterName	query	True	string	A javaslattevő neve az indexdefiníció részét képező javaslattevő-gyűjteményben megadottak szerint.
$filter	query		string	OData-kifejezés, amely szűri a javaslatoknak tekintett dokumentumokat.
$orderby	query		string[]	Az OData $orderby kifejezések listája, amelyek alapján rendezheti az eredményeket. Minden kifejezés lehet mezőnév vagy a geo.distance() vagy a search.score() függvény hívása. Az egyes kifejezéseket követheti az asc, amely növekvő vagy csökkenő jelzést jelez. Az alapértelmezett érték növekvő sorrend. A dokumentumok egyezésének pontszáma megszakítja a kötelékeket. Ha nincs megadva $orderby, az alapértelmezett rendezési sorrend a dokumentumegyezés pontszáma szerint csökkenő lesz. Legfeljebb 32 $orderby záradék lehet.
$select	query		string[]	A lekérendő mezők listája. Ha nincs meghatározva, csak a kulcsmező szerepel az eredmények között.
$top	query		integer int32	A lekérendő javaslatok száma. Az értéknek 1 és 100 közötti számnak kell lennie. Az alapértelmezett érték 5.
fuzzy	query		boolean	Egy érték, amely azt jelzi, hogy a javaslatok lekérdezéséhez használjon-e homályos egyezést. Az alapértelmezett érték hamis. Ha igaz értékre van állítva, a lekérdezés akkor is megkeresi a kifejezéseket, ha egy helyettesítő vagy hiányzó karakter szerepel a keresési szövegben. Bár ez jobb élményt nyújt bizonyos helyzetekben, teljesítményköltséggel jár, mivel a homályos javaslatok lekérdezései lassabbak és több erőforrást használnak fel.
highlightPostTag	query		string	Egy sztringcímke, amely a kiemelések eléréséhez van hozzáfűzve. A highlightPreTag értéket kell megadni. Ha nincs megadva, a javaslatok kiemelése le van tiltva.
highlightPreTag	query		string	Egy sztringcímke, amely elő van állítva a kiemelések eléréséhez. A highlightPostTag értéket kell beállítani. Ha nincs megadva, a javaslatok kiemelése le van tiltva.
minimumCoverage	query		number double	0 és 100 közötti szám, amely az index azon százalékát jelzi, amelyet egy javaslati lekérdezésnek tartalmaznia kell ahhoz, hogy a lekérdezés sikeres legyen. Ez a paraméter akkor is hasznos lehet, ha csak egy replikával rendelkező szolgáltatások esetében is biztosítja a keresés rendelkezésre állását. Az alapértelmezett érték 80.
searchFields	query		string[]	A megadott keresési szövegre keresni kívánt mezőnevek listája. A célmezőknek szerepelnie kell a megadott javaslattevőben.

Kérelem fejléce

Name	Kötelező	Típus	Description
x-ms-client-request-id		string uuid	A kéréssel együtt küldött nyomkövetési azonosító, amely segít a hibakeresésben.

Válaszok

Name	Típus	Description
200 OK	SuggestDocumentsResult	A részleges bemenetnek megfelelő javasolt dokumentumokat tartalmazó válasz.
Other Status Codes	ErrorResponse	Hibaválasz.

Példák

SearchIndexSuggestDocumentsGet

Mintakérelem

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=2024-07-01

Mintaválasz

Állapotkó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"
    }
  ]
}

Definíciók

Name	Description
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
SuggestDocumentsResult	Javaslati lekérdezési eredményeket tartalmazó válasz egy indexből.
SuggestResult	Egy javaslati lekérdezés által talált dokumentumot és a kapcsolódó metaadatokat tartalmazó eredmény.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

SuggestDocumentsResult

Javaslati lekérdezési eredményeket tartalmazó válasz egy indexből.

Name	Típus	Description
@search.coverage	number	Egy érték, amely a lekérdezésben szereplő index százalékos arányát jelzi, vagy null értéket, ha a kérelemben nem volt megadva a minimális hozzáférés.
value	SuggestResult[]	A lekérdezés által visszaadott eredmények sorozata.

SuggestResult

Egy javaslati lekérdezés által talált dokumentumot és a kapcsolódó metaadatokat tartalmazó eredmény.

Name	Típus	Description
@search.text	string	A javaslat eredményének szövege.

Megosztás a következőn keresztül: