Kueri istilah (terms query) mirip dengan kueri tepat (term query), tetapi mendukung beberapa kata kunci. Satu baris data dikembalikan jika nilai kolomnya sesuai dengan setidaknya salah satu kata kunci tersebut. Kueri istilah dapat digunakan seperti operator IN dalam pernyataan SQL.
Operasi API
Anda dapat memanggil operasi Search atau ParallelScan dan mengatur jenis kueri ke TermsQuery untuk menjalankan kueri istilah.
Parameter
Parameter | Deskripsi |
query | Jenis kueri. Atur parameter query ke TermsQuery. |
fieldName | Nama bidang yang ingin Anda cocokkan. |
terms |
Kata kunci pencarian yang ingin dicocokkan. Anda dapat menentukan hingga 1.024 terms. Satu baris data dikembalikan ketika nilai kolom sesuai dengan setidaknya salah satu kata kunci tersebut. |
getTotalCount | Menentukan apakah jumlah total baris yang memenuhi kondisi kueri dikembalikan. Nilai default parameter ini adalah false, yang berarti jumlah total baris yang memenuhi kondisi kueri tidak dikembalikan. Jika Anda mengatur parameter ini ke true, performa kueri akan menurun. |
weight | Bobot yang ingin Anda tetapkan pada bidang yang ingin Anda kueri untuk menghitung skor relevansi kata kunci berbasis BM25. Parameter ini digunakan dalam skenario pencarian teks lengkap. Jika Anda menetapkan bobot lebih tinggi untuk bidang yang ingin Anda kueri, skor relevansi kata kunci berbasis BM25 untuk bidang tersebut akan lebih tinggi. Nilai parameter ini adalah bilangan floating point positif. Parameter ini tidak memengaruhi jumlah baris yang dikembalikan. Namun, parameter ini memengaruhi skor relevansi kata kunci berbasis BM25 dari hasil kueri. |
tableName | Nama tabel data. |
indexName | Nama indeks pencarian. |
columnsToGet | Menentukan apakah semua kolom dari setiap baris yang memenuhi kondisi kueri dikembalikan. Anda dapat menentukan field returnAll dan columns untuk parameter ini. Nilai default field returnAll adalah false, yang berarti tidak semua kolom dikembalikan. Dalam kasus ini, Anda dapat menggunakan field columns untuk menentukan kolom yang ingin dikembalikan. Jika Anda tidak menentukan kolom yang ingin dikembalikan, hanya kolom kunci primer yang dikembalikan. Jika Anda mengatur field returnAll ke true, semua kolom dikembalikan. |
Metode
Anda dapat menggunakan Konsol Tablestore, CLI Tablestore, atau SDK Tablestore untuk menjalankan kueri istilah. Sebelum menjalankan kueri istilah, pastikan persiapan berikut telah dilakukan:
Anda memiliki Akun Alibaba Cloud atau Pengguna RAM yang memiliki izin untuk melakukan operasi pada Tablestore. Untuk informasi tentang cara memberikan izin operasi Tablestore kepada Pengguna RAM, lihat Gunakan kebijakan RAM untuk memberikan izin kepada Pengguna RAM.
Jika Anda ingin menggunakan SDK Tablestore atau CLI Tablestore untuk menjalankan kueri, pasangan Kunci Akses (AccessKey pair) telah dibuat untuk Akun Alibaba Cloud atau Pengguna RAM Anda. Untuk informasi selengkapnya, lihat Buat pasangan Kunci Akses.
Tabel data telah dibuat. Untuk informasi selengkapnya, lihat Operasi pada tabel.
Indeks pencarian telah dibuat untuk tabel data. Untuk informasi selengkapnya, lihat Buat indeks pencarian.
Jika Anda ingin menggunakan SDK Tablestore untuk menjalankan kueri, instans OTSClient telah diinisialisasi. Untuk informasi selengkapnya, lihat Inisialisasi instans OTSClient.
Jika Anda ingin menggunakan CLI Tablestore untuk menjalankan kueri, CLI Tablestore telah diunduh dan dijalankan, serta informasi instans yang ingin Anda akses telah dikonfigurasi. Untuk informasi selengkapnya, lihat Unduh CLI Tablestore dan Jalankan CLI Tablestore dan konfigurasi informasi akses.
Penagihan
Mengkueri data menggunakan Indeks Pencarian mengonsumsi throughput baca. Untuk informasi selengkapnya, lihat Metering dan penagihan Indeks Pencarian.
FAQ
Referensi
Search Index mendukung berbagai jenis kueri untuk data multidimensi, termasuk kueri tepat, kueri istilah, pencocokan semua kueri, kueri cocok, kueri pencocokan frasa, kueri rentang, kueri awalan, kueri akhiran, kueri wildcard, kueri wildcard berbasis token, kueri multi-bidang, kueri geografis, kueri bersarang, Pencarian vektor, dan kueri eksistensi.
Saat mengkueri data, Anda dapat mengurutkan dan melakukan paginasi set hasil atau melakukan collapsing (deduplikasi).
Untuk analisis data, seperti mencari nilai maksimum atau minimum, menghitung jumlah, atau menghitung baris, Anda dapat menggunakan fitur agregasi statistik atau kueri SQL.
Untuk mengekspor data secara cepat tanpa memperhatikan urutan set hasil, Anda dapat menggunakan fitur Parallel Scan.