Tablestore：Kueri jarak geografis

1. Pergi ke tab Indexes.

   1. Masuk ke konsol Tablestore.

   2. Di bilah navigasi atas, pilih grup sumber daya dan wilayah.

   3. Di halaman Overview, klik nama instance yang ingin dikelola atau pilih Manage Instance di kolom Actions.

   4. Di tab Tables pada halaman Instance Details, klik nama tabel data atau pilih Indexes di kolom Tindakan tabel data.

2. Di tab Indexes, temukan indeks pencarian yang ingin digunakan dan klik Manage Data di kolom Actions.

3. Di kotak dialog Search, konfigurasikan parameter kueri.

   1. Secara default, sistem mengembalikan semua kolom atribut. Untuk mengembalikan kolom tertentu, nonaktifkan All Columns dan tentukan kolom yang ingin dikembalikan. Pisahkan beberapa kolom dengan koma (,).

      Catatan

      Secara default, sistem mengembalikan semua kolom kunci utama tabel data.

   2. Pilih operator logika And, Or, atau Not sesuai kebutuhan bisnis Anda.

      Jika Anda memilih operator logika And, data yang memenuhi kondisi kueri dikembalikan. Jika Anda memilih operator Or dan menentukan satu kondisi kueri, data yang memenuhi kondisi kueri dikembalikan. Jika Anda memilih operator logika Atau 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 bertipe data GEOPOINT dan klik Add.

   4. Atur tipe kueri bidang indeks ke GeoDistanceQuery, masukkan koordinat titik pusat, dan tentukan jarak.

      Untuk memasukkan beberapa koordinat titik pusat, ulangi langkah sebelumnya.

   5. Secara default, fitur pengurutan dinonaktifkan. Untuk mengurutkan hasil kueri berdasarkan bidang tertentu, aktifkan Sort dan tentukan bidang serta urutan pengurutan.

   6. Secara default, fitur agregasi dinonaktifkan. Untuk mengumpulkan statistik pada bidang tertentu, aktifkan Collect Statistics, tentukan bidang yang ingin dianalisis, dan konfigurasikan informasi yang diperlukan.

4. Klik OK.

   Data yang memenuhi kondisi kueri akan ditampilkan di tab Indexes.

Anda dapat menggunakan CLI Tablestore untuk menjalankan perintah search guna mengkueri data menggunakan indeks pencarian. Untuk informasi lebih lanjut, lihat Indeks pencarian.

1. Jalankan perintah search untuk menggunakan indeks pencarian search_index dan mengembalikan semua kolom terindeks setiap baris yang memenuhi kondisi kueri.

   search -n search_index --return_all_indexed

2. Contoh kode berikut menunjukkan cara memasukkan kondisi kueri seperti yang diprompt oleh sistem:

   {
       "Offset": -1,
       "Limit": 10,
       "Collapse": null,
       "Sort": null,
       "GetTotalCount": true,
       "Token": null,
       "Query": {
           "Name": "GeoDistanceQuery",
           "Query": {
               "FieldName": "col_geopoint",
               "CenterPoint": "35.8,-45.91",
               "DistanceInMeter": 100.0
           }
       }
   }

Anda dapat menjalankan kueri jarak geografis menggunakan SDK Tablestore untuk Java, SDK Tablestore untuk Go, SDK Tablestore untuk Python, SDK Tablestore untuk Node.js, SDK Tablestore untuk .NET, dan SDK Tablestore untuk PHP. Contoh berikut menggunakan SDK Tablestore untuk Java untuk menggambarkan cara menjalankan kueri jarak geografis.

Contoh kode berikut menunjukkan cara mengkueri baris di mana nilai kolom Col_GeoPoint berada dalam jarak tertentu dari titik pusat.

public static void geoDistanceQuery(SyncClient client) {
    SearchQuery searchQuery = new SearchQuery();
    GeoDistanceQuery geoDistanceQuery = new GeoDistanceQuery();  // Gunakan GeoDistanceQuery. 
    geoDistanceQuery.setFieldName("Col_GeoPoint");
    geoDistanceQuery.setCenterPoint("5,5"); // Tentukan koordinat titik pusat. 
    geoDistanceQuery.setDistanceInMeter(10000); // Atur jarak dari titik pusat ke nilai lebih besar dari atau sama dengan 10.000. Satuan: meter. 
    searchQuery.setQuery(geoDistanceQuery);
    //searchQuery.setGetTotalCount(true); // Atur parameter GetTotalCount ke true untuk mengembalikan jumlah total baris yang memenuhi kondisi kueri. 

    SearchRequest searchRequest = new SearchRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>", searchQuery);
    // Anda dapat menggunakan parameter columnsToGet untuk menentukan kolom yang ingin Anda kembalikan atau menentukan bahwa semua kolom dikembalikan. Jika Anda tidak menentukan parameter ini, hanya kolom kunci utama yang dikembalikan. 
    //SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
    //columnsToGet.setReturnAll(true); // Tentukan bahwa semua kolom dikembalikan. 
    //columnsToGet.setColumns(Arrays.asList("ColName1","ColName2")); // Tentukan kolom yang ingin Anda kembalikan. 
    //searchRequest.setColumnsToGet(columnsToGet);

    SearchResponse resp = client.search(searchRequest);
    //System.out.println("TotalCount: " + resp.getTotalCount()); // Tampilkan jumlah total baris yang memenuhi kondisi kueri alih-alih jumlah baris yang dikembalikan. 
    System.out.println("Row: " + resp.getRows());
}