Anda dapat menggunakan kueri rentang untuk menanyakan data dalam rentang tertentu. Jika tipe kolom yang ingin Anda tanyakan adalah TEXT, nilai-nilai kolom tersebut akan di-tokenisasi. Sebuah baris memenuhi kondisi kueri jika setidaknya salah satu token dalam baris cocok dengan rentang kueri.
Operasi API
Anda dapat memanggil operasi Search atau ParallelScan, serta mengatur tipe kueri menjadi RangeQuery untuk menjalankan kueri rentang.
Parameter
Parameter | Deskripsi |
fieldName | Nama kolom yang ingin Anda cocokkan. |
from | Nilai dari mana kueri dimulai. Saat menentukan kondisi rentang, Anda dapat menggunakan greaterThan untuk menentukan tanda lebih besar dari (>) dan greaterThanOrEqual untuk menentukan tanda lebih besar dari atau sama dengan (≥). |
to | Nilai pada saat kueri berakhir. Saat menentukan kondisi rentang, Anda dapat menggunakan lessThan untuk menentukan tanda kurang dari (<) dan lessThanOrEqual untuk menentukan tanda kurang dari atau sama dengan (≤). |
includeLower | Menentukan apakah akan menyertakan nilai parameter from dalam respons. Tipe: BOOLEAN. |
includeUpper | Menentukan apakah akan menyertakan nilai parameter to dalam respons. Tipe: BOOLEAN. |
query | Tipe kueri. Atur parameter query ke RangeQuery. |
sort | Metode pengurutan. Untuk informasi lebih lanjut, lihat Melakukan pengurutan dan paging. |
getTotalCount | Menentukan apakah akan mengembalikan jumlah total baris yang memenuhi kondisi kueri. Nilai default dari parameter ini adalah false, yang menentukan bahwa jumlah total baris yang memenuhi kondisi kueri tidak dikembalikan. Jika Anda mengatur parameter ini ke true, performa kueri akan terpengaruh. |
tableName | Nama tabel data. |
indexName | Nama indeks pencarian. |
columnsToGet | Menentukan apakah akan mengembalikan semua kolom dari setiap baris yang memenuhi kondisi kueri. Anda dapat menentukan bidang returnAll dan columns untuk parameter ini. Nilai default dari bidang returnAll adalah false, yang menentukan bahwa tidak semua kolom dikembalikan. Dalam hal ini, Anda dapat menggunakan bidang columns untuk menentukan kolom yang ingin Anda kembalikan. Jika Anda tidak menentukan kolom yang ingin Anda kembalikan, hanya kolom kunci utama yang dikembalikan. Jika Anda mengatur bidang returnAll ke true, semua kolom dikembalikan. |
Metode
Anda dapat menggunakan konsol Tablestore, CLI Tablestore, atau SDK Tablestore untuk menjalankan kueri rentang. Pastikan langkah-langkah persiapan berikut telah dilakukan sebelum melaksanakan kueri:
Anda memiliki akun Alibaba Cloud atau pengguna RAM dengan izin untuk menjalankan operasi pada Tablestore. Untuk informasi lebih lanjut 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, pastikan pasangan AccessKey telah dibuat untuk akun Alibaba Cloud atau pengguna RAM Anda. Untuk informasi lebih lanjut, lihat Buat pasangan AccessKey.
Tabel data telah dibuat. Untuk informasi lebih lanjut, lihat Operasi pada tabel.
Indeks pencarian telah dibuat untuk tabel data. Untuk informasi lebih lanjut, lihat Buat indeks pencarian.
Jika Anda ingin menggunakan SDK Tablestore untuk menjalankan kueri, instance OTSClient harus diinisialisasi. Untuk informasi lebih lanjut, lihat Inisialisasi klien Tablestore.
Jika Anda ingin menggunakan CLI Tablestore untuk menjalankan kueri, pastikan CLI Tablestore telah diunduh dan dimulai, serta informasi tentang instance dan tabel data yang ingin Anda akses telah dikonfigurasi. Untuk informasi lebih lanjut, lihat Unduh CLI Tablestore, Mulai CLI Tablestore dan konfigurasikan informasi akses, dan Operasi pada tabel data.
Aturan penagihan
Saat Anda menggunakan indeks pencarian untuk menanyakan data, Anda dikenakan biaya untuk throughput baca yang dikonsumsi. Untuk informasi lebih lanjut, lihat Item yang dapat ditagih dari indeks pencarian.
FAQ
Referensi
Saat Anda menggunakan indeks pencarian untuk menanyakan data, Anda dapat menggunakan metode kueri berikut: kueri tepat, kueri terms, kueri match all, kueri match, kueri match phrase, kueri prefix, kueri rentang, kueri wildcard, kueri fuzzy, kueri Boolean, kueri geo, kueri nested, kueri vektor KNN, dan kueri exists. Anda dapat memilih metode kueri berdasarkan kebutuhan bisnis Anda untuk menanyakan data dari berbagai dimensi.
Anda dapat mengurutkan atau membagi halaman baris yang memenuhi kondisi kueri dengan menggunakan fitur pengurutan dan paginasi. Untuk informasi lebih lanjut, lihat Melakukan pengurutan dan paginasi.
Anda dapat menggunakan fitur collapse (distinct) untuk menggabungkan set hasil berdasarkan kolom tertentu. Dengan cara ini, data dari tipe yang ditentukan hanya muncul sekali dalam hasil kueri. Untuk informasi lebih lanjut, lihat Collapse (distinct).
Jika Anda ingin menganalisis data dalam tabel data, Anda dapat menggunakan fitur agregasi operasi Search atau menjalankan pernyataan SQL. Sebagai contoh, Anda bisa mendapatkan nilai minimum dan maksimum, jumlah total, dan jumlah baris. Untuk informasi lebih lanjut, lihat Agregasi dan Kueri SQL.
Jika Anda ingin mendapatkan semua baris yang memenuhi kondisi kueri tanpa perlu mengurutkan baris, Anda dapat memanggil operasi ParallelScan dan ComputeSplits untuk menggunakan fitur pemindaian paralel. Untuk informasi lebih lanjut, lihat Pemindaian paralel.