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 field returnAll dan columns untuk parameter ini. Nilai default field returnAll adalah false, yang berarti tidak semua kolom dikembalikan. Dalam hal ini, Anda dapat menggunakan field columns untuk menentukan kolom yang ingin dikembalikan. Jika Anda tidak menentukan kolom yang ingin dikembalikan, hanya kolom kunci primer yang dikembalikan. Jika Anda mengatur field 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 command-line, buat AccessKey untuk Akun Alibaba Cloud atau RAM user Anda jika belum memilikinya.
Anda telah membuat tabel data.
Indeks Pencarian telah dibuat untuk tabel data tersebut.
Jika Anda menggunakan SDK, inisialisasi Tablestore Client.
Jika Anda menggunakan tool command-line, unduh dan jalankan tool tersebut, lalu konfigurasikan koneksi ke instans Anda dan pilih tabel target. Untuk informasi lebih lanjut, lihat Unduh tool command-line, Jalankan tool dan konfigurasikan informasi koneksi, dan Operasi tabel data.
Penagihan
Mengkueri data menggunakan Indeks Pencarian mengonsumsi throughput baca. Untuk informasi lebih lanjut, lihat Metering dan penagihan Indeks Pencarian.
FAQ
Referensi
Indeks Pencarian 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 jumlah 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.