Dukungan untuk OData (Pencarian Azure AI)
Azure AI layanan Pencarian API menggunakan Open Data Protocol (OData) untuk kueri indeks. Azure AI Search mendukung OData versi 4.
Sintaks OData di header permintaan HTTP
OData menentukan beberapa header permintaan HTTP yang dapat Anda atur secara opsional. Anda dapat menggunakan nilai khusus OData untuk header Terima seperti application/json;odata.metadata=none
untuk mengontrol jumlah metadata yang disertakan dalam respons. Default adalah odata.metadata=minimal
. Untuk singkatnya, semua contoh dalam dokumen ini mengasumsikan odata.metadata=none
.
Header lain yang dapat Anda atur adalah OData-MaxVersion
. AZURE AI Search Service API mendukung OData V4 sehingga Anda harus mengatur OData-MaxVersion
ke "4.0". Ini memberi tahu API untuk mengharapkan format OData V4 dalam isi permintaan, dan untuk mengirim respons dalam format OData V4. Di masa mendatang saat kami menambahkan dukungan untuk versi protokol OData yang lebih baru, Anda dapat mengatur header ini ke nilai yang berbeda. Azure AI layanan Pencarian API tidak mendukung versi OData yang lebih lama dari V4.
Lihat Sintaks Ekspresi OData untuk Pencarian Azure AI untuk detail tentang menggunakan OData dalam filter dan ekspresi pengurutan. Lihat Sintaks kueri sederhana di Azure AI Search untuk sintaks alternatif.
layanan Pencarian API dengan sintaks OData Alternatif
API layanan Pencarian mendukung sintaks OData untuk pencarian entitas. Ini berlaku baik untuk kedua dokumen dalam indeks, serta untuk mengindeks dirinya sendiri (di mana nama indeks adalah kunci entitas). Berikut adalah ringkasan semua API yang memiliki sintaks OData alternatif:
Memperbarui Indeks
PUT /indexes('[index name]')?api-version=2015-02-28
Mendapatkan Indeks
GET /indexes('[index name]')?api-version=2015-02-28
Mendapatkan Statistik Indeks
GET /indexes('[index name]')/stats?api-version=2015-02-28
Menghapus Indeks
DELETE /indexes('[index name]')?api-version=2015-02-28
Menambahkan dan Menghapus Data dalam Indeks
POST /indexes('[index name]')/docs/index?api-version=2015-02-28
Cari
GET /indexes('[index name]')/docs?[query parameters]
Lookup
GET /indexes('[index name]')/docs('[key]')?[query parameters]
Menghitung
GET /indexes('[index name]')/docs/$count?api-version=2015-02-28
Saran
GET /indexes('[index name]')/docs/suggest?[query parameters]