Kueri sufiks (SuffixQuery) menemukan data dalam indeks pencarian yang diakhiri dengan string tertentu. Misalnya, Anda dapat mencari pengiriman paket berdasarkan empat digit terakhir nomor telepon.
Cara kerja
Gunakan kueri sufiks untuk menemukan data yang diakhiri dengan sufiks tertentu. Untuk menjalankan SuffixQuery, Anda harus menentukan sufiks yang akan dicocokkan.
Satu-satunya tipe data yang mendukung kueri sufiks adalah FuzzyKeyword. Tipe data ini dioptimalkan untuk operasi pencarian fuzzy seperti SuffixQuery, PrefixQuery, dan wildcard query, serta memberikan performa yang lebih baik dan stabil pada set data kecil, menengah, maupun besar tanpa penurunan signifikan seiring peningkatan volume data.
-
Bidang bertipe
FuzzyKeywordtidak mendukung pengurutan atau agregasi. Jika Anda perlu melakukan pengurutan atau agregasi pada bidang tersebut, buatlahvirtual columnbertipeKeyworduntuk tujuan tersebut. -
Untuk mensimulasikan kueri sufiks pada bidang
Keyword, balikkan string saat menulis data, lalu gunakan kueri awalan (PrefixQuery) untuk mencarinya.
API
Lakukan kueri sufiks dengan memanggil operasi Search atau ParallelScan, lalu atur tipe kueri menjadi SuffixQuery.
Parameter
|
Parameter |
Deskripsi |
|
query |
Atur tipe kueri menjadi SuffixQuery. |
|
fieldName |
Bidang yang akan dicocokkan. |
|
suffix |
Nilai sufiks. |
|
getTotalCount |
Menentukan apakah jumlah total baris yang cocok dikembalikan. Nilai default-nya adalah false. Mengembalikan jumlah total baris yang cocok memengaruhi performa kueri. |
|
weight |
Bobot kueri. Parameter ini digunakan untuk pengurutan berbasis skor dalam skenario indeks teks penuh. Nilai bobot yang lebih tinggi menghasilkan skor yang lebih tinggi untuk baris yang cocok. Nilainya harus berupa bilangan titik mengambang positif. Parameter ini hanya memengaruhi skor hasil yang dikembalikan, bukan jumlah hasilnya. |
|
tableName |
Nama tabel data. |
|
indexName |
Nama indeks pencarian. |
|
columnsToGet |
Kolom yang akan dikembalikan. Ini mencakup pengaturan returnAll dan columns. Secara default, returnAll bernilai false. Jika returnAll bernilai false, Anda dapat menggunakan columns untuk menentukan kolom yang dikembalikan. Jika Anda tidak menentukan columns, hanya kolom kunci primer yang dikembalikan. Jika Anda mengatur returnAll menjadi true, semua kolom dikembalikan. |
Penggunaan
Anda dapat melakukan kueri sufiks menggunakan Konsol Tablestore atau SDK. Pastikan prasyarat berikut telah dipenuhi sebelum memulai:
-
Anda telah membuat
RAM userdan memberikan izin akses ke Tablestore. Untuk informasi selengkapnya, lihat Gunakan Pasangan Kunci Akses RAM user untuk mengakses Tablestore. -
Anda telah membuat tabel data. Untuk informasi selengkapnya, lihat Operasi pada tabel data.
-
Anda telah membuat indeks pencarian untuk tabel data tersebut. Untuk informasi selengkapnya, lihat Buat indeks pencarian.
Penagihan
Mengkueri data menggunakan Indeks Pencarian mengonsumsi throughput baca. Untuk informasi selengkapnya, lihat Metering dan penagihan Indeks Pencarian.
FAQ
Topik terkait
Indeks Pencarian mendukung berbagai jenis kueri untuk kueri data multidimensi, termasuk term query, terms query, match all query, match query, phrase match query, range query, prefix query, suffix query, wildcard query, token-based wildcard query, boolean query, geo query, nested query, vector search, dan exists query.
Saat mengkueri data, Anda dapat mengurutkan dan melakukan paginasi pada 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 memedulikan urutan set hasil, Anda dapat menggunakan fitur Parallel Scan.