Kueri kotak pembatas geografis memungkinkan Anda menentukan area geografis berbentuk persegi panjang sebagai kondisi kueri. Tablestore mengembalikan baris-baris yang nilai bidang yang ditentukan berada dalam area geografis persegi panjang tersebut.
Operasi API
Anda dapat mengatur tipe kueri ke GeoBoundingBoxQuery dalam operasi Search atau ParallelScan untuk menjalankan kueri kotak pembatas geografis.
Parameter
|
Parameter |
Deskripsi |
|
fieldName |
Nama kolom yang ingin Anda kueri. Nilai parameter ini bertipe data GEOPOINT. |
|
topLeft |
Pasangan koordinat sudut kiri atas dari area geografis persegi panjang. |
|
bottomRight |
Pasangan koordinat sudut kanan bawah dari area geografis persegi panjang. Area geografis persegi panjang dapat ditentukan dengan menggunakan sudut kiri atas dan sudut kanan bawah. Formatnya adalah |
|
query |
Pernyataan kueri untuk indeks pencarian. Atur parameter ini ke GeoBoundingBoxQuery. |
|
getTotalCount |
Menentukan apakah jumlah total baris yang memenuhi kondisi kueri dikembalikan. Nilai default parameter ini adalah false, yang berarti jumlah total baris tidak dikembalikan. Jika Anda mengatur parameter ini ke true, performa kueri akan menurun. |
|
tableName |
Nama tabel data. |
|
indexName |
Nama indeks pencarian. |
|
columnsToGet |
Menentukan apakah semua kolom dari setiap baris yang memenuhi kondisi kueri dikembalikan. Anda dapat menentukan bidang returnAll dan columns untuk parameter ini. Nilai default bidang returnAll adalah false, yang berarti tidak semua kolom dikembalikan. Dalam hal ini, Anda dapat menggunakan bidang columns untuk menentukan kolom yang ingin dikembalikan. Jika Anda tidak menentukan kolom yang ingin dikembalikan, hanya kolom kunci primer yang dikembalikan. Jika Anda mengatur bidang returnAll ke true, semua kolom dikembalikan. |
Metode
Anda dapat menjalankan kueri kotak pembatas geografis menggunakan Konsol Tablestore, CLI Tablestore, dan SDK Tablestore. Sebelum menjalankan kueri kotak pembatas geografis, pastikan prasyarat berikut terpenuhi:
Gunakan Akun Alibaba Cloud atau RAM user dengan izin yang diperlukan untuk operasi Table Store. Untuk memberikan izin kepada RAM user, lihat Berikan izin kepada RAM user menggunakan kebijakan RAM.
Jika Anda menggunakan SDK atau tool baris perintah, buat AccessKey untuk Akun Alibaba Cloud atau RAM user Anda jika belum memilikinya.
Anda telah membuat tabel data.
Search Index telah dibuat untuk tabel data tersebut.
Jika Anda menggunakan SDK, inisialisasi Tablestore Client.
Jika Anda menggunakan tool baris perintah, unduh dan jalankan tool tersebut, lalu konfigurasikan koneksi ke instans Anda dan pilih tabel target. Untuk informasi selengkapnya, lihat Unduh tool baris perintah, Jalankan tool dan konfigurasikan informasi koneksi, dan Operasi tabel data.
Penagihan
Mengkueri data menggunakan Search Index mengonsumsi throughput baca. Untuk informasi selengkapnya, lihat Metering dan penagihan Search Index.
FAQ
Referensi
Search Index mendukung berbagai tipe kueri untuk kueri 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 membagi hasil menjadi halaman 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.