Kueri terms mirip dengan kueri term, tetapi mendukung beberapa kata kunci. Data akan dikembalikan jika setidaknya satu kata kunci cocok persis dengan nilai bidang. Kueri ini dapat digunakan seperti Operator IN dalam pernyataan SQL.
Prasyarat
Instance OTSClient telah diinisialisasi. Untuk detail lebih lanjut, lihat Inisialisasi instance OTSClient.
Tabel data telah dibuat dan data telah ditulis ke tabel tersebut. Untuk informasi lebih lanjut, lihat Buat tabel data dan Tulis data.
Indeks pencarian telah dibuat untuk tabel data. Untuk detail lebih lanjut, lihat Buat indeks pencarian.
Parameter
Parameter | Deskripsi |
tableName | Nama tabel data. |
indexName | Nama indeks pencarian. |
offset | Posisi dari mana kueri saat ini dimulai. |
limit | Jumlah maksimum baris yang ingin Anda kembalikan dalam kueri saat ini. Untuk hanya menanyakan jumlah baris yang memenuhi kondisi kueri tanpa data spesifik, atur parameter limit ke 0. |
queryType | Tipe kueri. Untuk menggunakan kueri terms, atur parameter ini ke TableStore.QueryType.TERMS_QUERY. |
fieldName | Nama bidang yang ingin Anda cocokkan. |
terms | Kata kunci yang digunakan untuk mencocokkan nilai bidang saat Anda melakukan kueri terms. Sebaris data akan dikembalikan jika setidaknya salah satu kata kunci cocok persis dengan nilai bidang. |
getTotalCount | Menentukan apakah akan mengembalikan jumlah total baris yang memenuhi kondisi kueri. Nilai default: false. Jika Anda mengatur parameter ini ke true, performa kueri akan berkurang. |
columnToGet | Menentukan apakah akan mengembalikan semua kolom dari setiap baris yang memenuhi kondisi kueri. Anda dapat mengonfigurasi returnType dan returnNames untuk parameter ini.
|
Contoh
Berikut adalah contoh kode untuk menanyakan baris di mana nilai kolom Col_Keyword cocok persis dengan "hangzhou" atau "shanghai":
/**
* Cari tabel untuk baris di mana nilai kolom Col_Keyword cocok persis dengan "hangzhou" atau "shanghai".
* TermsQuery mendukung beberapa istilah. Anda dapat mengambil hasil kueri yang cocok dengan setidaknya salah satu istilah.
*/
client.search({
tableName: TABLE_NAME,
indexName: INDEX_NAME,
searchQuery: {
offset: 0,
limit: 10, // Untuk hanya menanyakan jumlah baris yang memenuhi kondisi kueri tanpa data spesifik, atur parameter limit ke 0.
query: { // Atur tipe kueri ke TableStore.QueryType.TERMS_QUERY.
queryType: TableStore.QueryType.TERMS_QUERY,
query: {
fieldName: "Col_Keyword",
terms: ["hangzhou", "shanghai"]
}
},
getTotalCount: true // Tentukan apakah akan mengembalikan jumlah total baris yang memenuhi kondisi kueri. Nilai default: false.
},
columnToGet: { // Tentukan kolom yang ingin Anda kembalikan. Anda dapat mengatur parameter ini ke RETURN_SPECIFIED untuk mengembalikan kolom tertentu, RETURN_ALL untuk mengembalikan semua kolom, RETURN_ALL_FROM_INDEX untuk mengembalikan semua kolom dalam indeks pencarian, atau RETURN_NONE untuk mengembalikan hanya kolom kunci utama.
returnType: TableStore.ColumnReturnType.RETURN_ALL
}
}, function (err, data) {
if (err) {
console.log('error:', err);
return;
}
console.log('success:', JSON.stringify(data, null, 2));
});FAQ
FAQ
Referensi
Jenis kueri berikut didukung oleh indeks pencarian: kueri term, kueri terms, kueri match all, kueri match, kueri match phrase, kueri prefix, kueri range, kueri wildcard, kueri Boolean, kueri geo, kueri nested, kueri vector, dan kueri exists. Pilih jenis kueri sesuai kebutuhan bisnis Anda.
Untuk mengurutkan atau membagi halaman baris yang memenuhi kondisi kueri, gunakan fitur Pengurutan dan paging. Untuk informasi lebih lanjut, lihat Pengurutan dan paging.
Untuk meruntuhkan set hasil berdasarkan kolom tertentu, gunakan fitur collapse (distinct). Dengan cara ini, data dari tipe tertentu hanya muncul sekali dalam hasil kueri. Untuk informasi lebih lanjut, lihat Collapse (distinct).
Untuk menganalisis data dalam tabel, seperti mendapatkan nilai ekstrem, jumlah, atau total baris, gunakan operasi agregasi atau jalankan pernyataan SQL. Untuk informasi lebih lanjut, lihat Agregasi dan Kueri SQL.
Untuk mendapatkan semua baris yang memenuhi kondisi kueri tanpa perlu pengurutan, gunakan operasi ParallelScan dan ComputeSplits untuk memanfaatkan fitur pemindaian paralel. Untuk informasi lebih lanjut, lihat Pemindaian paralel.