Documents - Suggest Get

Layanan:: Search Service

Versi API:: 2025-08-01-preview

Menyarankan dokumen dalam indeks yang cocok dengan teks kueri parsial yang diberikan.

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

Dengan parameter opsional:

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-08-01-preview

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string	URL titik akhir layanan pencarian.
indexName	path	True	string	Nama indeks.
api-version	query	True	string	Versi API Klien.
search	query	True	string	Teks pencarian yang akan digunakan untuk menyarankan dokumen. Harus minimal 1 karakter, dan tidak lebih dari 100 karakter.
suggesterName	query	True	string	Nama pemberi saran seperti yang ditentukan dalam kumpulan saran yang merupakan bagian dari definisi indeks.
$filter	query		string	Ekspresi OData yang memfilter dokumen yang dipertimbangkan untuk saran.
$orderby	query		string[]	Daftar ekspresi $orderby OData untuk mengurutkan hasilnya. Setiap ekspresi dapat berupa nama bidang atau panggilan ke fungsi geo.distance() atau search.score(). Setiap ekspresi dapat diikuti oleh asc untuk menunjukkan naik, atau desc untuk menunjukkan turun. Defaultnya adalah urutan menaik. Ikatan akan diputuskan oleh skor pertandingan dokumen. Jika tidak ada $orderby yang ditentukan, urutan pengurutan default adalah menurun berdasarkan skor kecocokan dokumen. Mungkin ada paling banyak 32 klausa $orderby.
$select	query		string[]	Daftar bidang yang akan diambil. Jika tidak ditentukan, hanya bidang kunci yang akan disertakan dalam hasil.
$top	query		integer (int32)	Jumlah saran yang akan diambil. Nilainya harus berupa angka antara 1 dan 100. Pengaturan awal adalah 5.
fuzzy	query		boolean	Nilai yang menunjukkan apakah akan menggunakan pencocokan fuzzy untuk kueri saran. Secara default adalah false. Jika diatur ke true, kueri akan menemukan istilah meskipun ada karakter yang diganti atau hilang dalam teks pencarian. Meskipun ini memberikan pengalaman yang lebih baik dalam beberapa skenario, ini datang dengan biaya performa karena kueri saran kabur lebih lambat dan menghabiskan lebih banyak sumber daya.
highlightPostTag	query		string	Tag string yang ditambahkan ke sorotan klik. Harus diatur dengan highlightPreTag. Jika dihilangkan, tekan penyorotan saran dinonaktifkan.
highlightPreTag	query		string	Tag string yang dilanjutkan untuk menekan sorotan. Harus diatur dengan highlightPostTag. Jika dihilangkan, tekan penyorotan saran dinonaktifkan.
minimumCoverage	query		number (double)	Angka antara 0 dan 100 yang menunjukkan persentase indeks yang harus dicakup oleh kueri saran agar kueri dilaporkan sebagai keberhasilan. Parameter ini dapat berguna untuk memastikan ketersediaan pencarian bahkan untuk layanan dengan hanya satu replika. Defaultnya adalah 80.
searchFields	query		string[]	Daftar nama bidang untuk mencari teks pencarian yang ditentukan. Bidang target harus disertakan dalam saran yang ditentukan.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
x-ms-client-request-id		string (uuid)	ID pelacakan yang dikirim dengan permintaan untuk membantu penelusuran kesalahan.

Respons

Nama	Jenis	Deskripsi
200 OK	SuggestDocumentsResult	Respons berisi dokumen yang disarankan yang cocok dengan input parsial.
Other Status Codes	ErrorResponse	Respons kesalahan.

Contoh

SearchIndexSuggestDocumentsGet

Permintaan sampel

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-08-01-preview

Respon sampel

Kode status:: 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"
    }
  ]
}

Definisi

Nama	Deskripsi
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
SuggestDocumentsResult	Respons yang berisi hasil kueri saran dari indeks.
SuggestResult	Hasil yang berisi dokumen yang ditemukan oleh kueri saran, ditambah metadata terkait.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

SuggestDocumentsResult

Objek

Respons yang berisi hasil kueri saran dari indeks.

Nama	Jenis	Deskripsi
@search.coverage	number (double)	Nilai yang menunjukkan persentase indeks yang disertakan dalam kueri, atau null jika minimumCoverage tidak diatur dalam permintaan.
value	SuggestResult[]	Urutan hasil yang ditampilkan oleh kueri.

SuggestResult

Objek

Hasil yang berisi dokumen yang ditemukan oleh kueri saran, ditambah metadata terkait.

Nama	Jenis	Deskripsi
@search.text	string	Teks hasil saran.