Kueri poligon geografis memungkinkan Anda menentukan area geografis berbentuk poligon sebagai kondisi kueri. Tablestore mengembalikan baris-baris yang nilai bidang tertentunya berada di dalam area geografis tersebut.
Operasi API
Anda dapat mengatur tipe kueri ke GeoPolygonQuery dalam operasi Search atau ParallelScan untuk menjalankan kueri poligon geografis.
Parameter
|
Parameter |
Deskripsi |
|
fieldName |
Nama kolom yang ingin Anda kueri. Nilai parameter ini bertipe data GEOPOINT. |
|
points |
Pasangan koordinat titik-titik yang mendefinisikan area geografis poligon. Nilai parameter ini harus dalam format |
|
query |
Pernyataan kueri untuk indeks pencarian. Atur parameter ini ke GeoPolygonQuery. |
|
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 poligon geografis menggunakan Konsol Tablestore, CLI Tablestore, dan SDK Tablestore. Sebelum menjalankan kueri poligon geografis, pastikan prasyarat berikut terpenuhi:
Gunakan Akun Alibaba Cloud atau Pengguna RAM dengan izin yang diperlukan untuk operasi Tablestore. Untuk memberikan izin kepada Pengguna RAM, lihat Berikan izin kepada Pengguna RAM menggunakan kebijakan RAM.
Jika Anda menggunakan SDK atau alat command-line, buat AccessKey untuk Akun Alibaba Cloud atau Pengguna RAM 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 alat command-line, unduh dan jalankan alat tersebut, lalu konfigurasikan koneksi ke instans Anda dan pilih tabel target. Untuk informasi selengkapnya, lihat Unduh alat command-line, Jalankan alat dan konfigurasikan informasi koneksi, dan Operasi tabel data.
Penagihan
Mengkueri data menggunakan Indeks Pencarian mengonsumsi throughput baca. Untuk informasi selengkapnya, 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 frasa cocok, kueri rentang, kueri awalan, kueri akhiran, kueri wildcard, kueri wildcard berbasis token, kueri multi-bidang, kueri geografis, kueri bersarang, pencarian vektor, dan kueri exists.
Saat mengkueri data, Anda dapat mengurutkan dan menerapkan 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 memperhatikan urutan set hasil, Anda dapat menggunakan fitur Parallel Scan.