kueri rentang indeks pencarian - Tablestore - Alibaba Cloud Documentation Center

Kueri rentang mengambil data dari tabel berdasarkan rentang yang ditentukan. Untuk bidang bertipe Text, kecocokan ditemukan jika ada token dalam nilai bidang tersebut yang memenuhi kondisi rentang.

Antarmuka

Anda dapat melakukan kueri rentang menggunakan operasi Search atau ParallelScan. Jenis kuerinya adalah RangeQuery.

Parameter

Parameter	Deskripsi
fieldName	Bidang yang akan dicocokkan.
from	Nilai posisi awal. Saat menetapkan kondisi rentang, gunakan `greaterThan` untuk menentukan lebih besar dari (>) atau `greaterThanOrEqual` untuk menentukan lebih besar dari atau sama dengan (>=).
to	Nilai posisi akhir. Saat menetapkan kondisi rentang, gunakan `lessThan` untuk menentukan kurang dari (<) atau `lessThanOrEqual` untuk menentukan kurang dari atau sama dengan (<=).
includeLower	Menentukan apakah nilai `from` disertakan dalam hasil. Tipenya Boolean.
includeUpper	Menentukan apakah nilai `to` disertakan dalam hasil. Tipenya Boolean.
query	Tetapkan jenis kueri menjadi RangeQuery.
sort	Mengurutkan hasil dalam urutan tertentu. Untuk informasi selengkapnya, lihat Pengurutan dan paginasi.
getTotalCount	Menentukan apakah jumlah total baris yang cocok dikembalikan. Nilai default-nya false, yang berarti jumlah total baris yang cocok tidak dikembalikan. Mengembalikan jumlah total baris yang cocok memengaruhi performa kueri.
tableName	Nama tabel data.
indexName	Nama indeks pencarian.
columnsToGet	Menentukan apakah semua kolom dikembalikan. Ini mencakup pengaturan `returnAll` dan `columns`. `returnAll` secara default bernilai false. Artinya, tidak semua kolom dikembalikan. Anda dapat menggunakan `columns` untuk menentukan kolom mana yang akan dikembalikan. Jika Anda tidak menggunakan `columns` untuk menentukan kolom, hanya kolom kunci primer yang dikembalikan. Jika Anda menetapkan `returnAll` ke true, semua kolom dikembalikan.

Penggunaan

Anda dapat melakukan kueri rentang menggunakan Konsol, antarmuka baris perintah, atau kit pengembangan perangkat lunak (SDK). Sebelum melakukan kueri rentang, lakukan persiapan berikut.

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 melakukan kueri, pasangan AccessKey telah dibuat untuk Akun Alibaba Cloud atau Pengguna RAM Anda. Untuk informasi selengkapnya, lihat Buat AccessKey.
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 melakukan kueri, instans OTSClient telah diinisialisasi. Untuk informasi selengkapnya, lihat Inisialisasi klien Tablestore.
Jika Anda ingin menggunakan CLI Tablestore untuk melakukan kueri, CLI Tablestore telah diunduh dan dijalankan, serta informasi tentang instans yang ingin Anda akses dan tabel data telah dikonfigurasi. Untuk informasi selengkapnya, lihat Unduh CLI Tablestore, Jalankan CLI Tablestore dan konfigurasikan informasi akses, dan Operasi tabel data.

Gunakan Konsol

Buka tab Indexes.
1. Masuk ke Konsol Tablestore.
2. Di bilah navigasi atas, pilih kelompok sumber daya dan Wilayah.
3. Di halaman Overview, klik nama instans yang ingin Anda kelola atau klik Manage Instance di kolom Actions instans tersebut.
4. Di tab Tables pada halaman Instance Details, klik nama tabel data atau klik Indexes di kolom Actions tabel data tersebut.
Di tab Indexes, temukan indeks pencarian yang ingin Anda gunakan untuk mengkueri data, lalu klik Manage Data di kolom Actions.
Di kotak dialog Query Data, Anda dapat mengkueri data.
1. Sistem secara default mengembalikan semua kolom atribut. Untuk mengembalikan kolom atribut tertentu, matikan All Columns dan tentukan kolom atribut yang ingin dikembalikan. Pisahkan beberapa kolom atribut dengan koma (,).
  Catatan
  Sistem secara default mengembalikan semua kolom kunci primer dari tabel data.
2. Pilih operator logika And, Or, atau Not sesuai kebutuhan bisnis Anda.
  Jika Anda memilih operator logika And, data yang memenuhi semua kondisi kueri dikembalikan. Jika Anda memilih operator Or dan menentukan satu kondisi kueri, data yang memenuhi kondisi tersebut dikembalikan. Jika Anda memilih operator Or dan menentukan beberapa kondisi kueri, data yang memenuhi salah satu kondisi kueri dikembalikan. Jika Anda memilih operator logika Not, data yang tidak memenuhi kondisi kueri dikembalikan.
3. Pilih bidang indeks dan klik Add.
4. Tetapkan jenis kueri untuk bidang indeks menjadi Range Query (RangeQuery) dan tentukan rentang kueri.
  
  Rentang kueri merupakan interval tertutup di kiri dan terbuka di kanan.
5. Fitur pengurutan secara default dinonaktifkan. Jika Anda ingin mengurutkan hasil kueri berdasarkan bidang tertentu, aktifkan Sort dan tentukan bidang yang digunakan untuk mengurutkan hasil kueri serta urutan pengurutannya.
6. Fitur agregasi secara default dinonaktifkan. Jika Anda ingin mengumpulkan statistik pada bidang tertentu, aktifkan Collect Statistics, tentukan bidang yang digunakan untuk mengumpulkan statistik, lalu konfigurasikan informasi yang diperlukan untuk pengumpulan statistik tersebut.
Klik OK.
Data yang memenuhi kondisi kueri ditampilkan dalam urutan yang ditentukan di tab Indexes.

Gunakan antarmuka baris perintah

Anda dapat menjalankan perintah search di antarmuka baris perintah untuk mengkueri data menggunakan indeks pencarian. Untuk informasi selengkapnya, lihat Indeks pencarian.

Jalankan perintah search untuk mengkueri data dari tabel menggunakan indeks pencarian `search_index`. Perintah ini mengembalikan semua kolom yang diindeks.
```
search -n search_index --return_all_indexed
```

Masukkan kondisi kueri seperti yang diminta oleh sistem. Berikut contohnya:

{
    "Offset": -1,
    "Limit": 10,
    "Collapse": null,
    "Sort": null,
    "GetTotalCount": true,
    "Token": null,
    "Query": {
        "Name": "RangeQuery",
        "Query": {
            "FieldName": "col_long",
            "From": 1,
            "To": 100,
            "IncludeLower": true,
            "IncludeUpper": false
        }
    }
}

Gunakan SDK

Anda dapat menggunakan Java SDK, Go SDK, Python SDK, Node.js SDK, .NET SDK, atau PHP SDK untuk melakukan kueri rentang. Topik ini menggunakan Java SDK sebagai contoh.

Aturan penagihan

Saat Anda menggunakan indeks pencarian untuk mengkueri data, Anda dikenai biaya berdasarkan throughput baca yang dikonsumsi. Untuk informasi selengkapnya, lihat Item yang dapat ditagih untuk indeks pencarian.

FAQ

Referensi

Saat menggunakan indeks pencarian untuk mengkueri data, Anda dapat menggunakan metode kueri berikut: kueri tepat, kueri istilah, Pencocokan semua kueri, kueri cocok, permintaan pencocokan frasa, kueri awalan, kueri rentang, kueri wildcard, kueri fuzzy, Boolean query, kueri geografis, kueri bersarang, Kueri vektor KNN, dan kueri exists. Anda dapat memilih metode kueri berdasarkan kebutuhan bisnis untuk mengkueri data dari berbagai dimensi.
Anda dapat mengurutkan atau menerapkan paginasi pada baris yang memenuhi kondisi kueri menggunakan fitur pengurutan dan paginasi. Untuk informasi selengkapnya, lihat Pengurutan dan paginasi.
Anda dapat menggunakan fitur collapse (distinct) untuk menciutkan set hasil berdasarkan kolom tertentu sehingga data jenis tertentu hanya muncul sekali dalam hasil kueri. Untuk informasi selengkapnya, lihat Collapse (hapus duplikat).
Jika Anda ingin menganalisis data dalam tabel data, Anda dapat menggunakan fitur agregasi operasi Search atau mengeksekusi pernyataan SQL. Misalnya, Anda dapat memperoleh nilai minimum dan maksimum, jumlah total, serta jumlah baris. Untuk informasi selengkapnya, lihat Agregasi dan Kueri SQL.
Jika Anda ingin memperoleh semua baris yang memenuhi kondisi kueri tanpa perlu mengurutkan baris tersebut, Anda dapat memanggil operasi ParallelScan dan ComputeSplits untuk menggunakan fitur pemindaian paralel. Untuk informasi selengkapnya, lihat Pemindaian paralel.