Tablestore:Kueri jarak geografis

1. Buka tab Index Management.

   1. Login ke Tablestore console.

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

   3. Di halaman Overview, klik nama instans atau klik Instance Management di kolom Actions.

   4. Di tab Instance Details, pada tab Data Table List, klik nama tabel data atau klik Index Management di kolom Actions.

2. Di tab Index Management, temukan Search Index target dan klik Search di kolom Actions.

3. Di kotak dialog Search, konfigurasikan parameter kueri.

   1. Secara default, semua kolom dikembalikan. Untuk mengembalikan kolom tertentu, matikan Retrieve All Columns dan masukkan nama kolom yang dipisahkan koma.

      Catatan

      Secara default, Tablestore mengembalikan kolom kunci primer dari tabel data.

   2. Pilih operator logika: And, Or, atau Not.

      Jika Anda memilih And, kueri mengembalikan data yang memenuhi semua kondisi yang ditentukan. Jika Anda memilih Or, kueri mengembalikan data yang memenuhi setidaknya satu dari kondisi yang ditentukan. Jika Anda memilih Not, kueri mengembalikan data yang tidak memenuhi kondisi yang ditentukan.

   3. Pilih bidang indeks bertipe GEOPOINT dan klik Add.

   4. Atur tipe kueri untuk bidang indeks ke GeoDistanceQuery. Masukkan koordinat titik pusat, pilih titik tersebut, lalu masukkan jarak.

      Jika Anda ingin memasukkan beberapa pasangan koordinat titik pusat, ulangi langkah sebelumnya.

   5. Secara default, pengurutan dimatikan. Untuk mengurutkan hasil berdasarkan bidang tertentu, aktifkan Enable Sorting, tambahkan bidang pengurutan, lalu konfigurasikan urutan pengurutan.

   6. Secara default, agregasi dimatikan. Untuk melakukan agregasi statistik pada bidang tertentu, aktifkan Enable Aggregation, tambahkan bidang untuk agregasi, lalu konfigurasikan pengaturan agregasi.

4. Klik OK.

   Hasil kueri ditampilkan di tab Index Management.

Anda dapat menggunakan CLI Tablestore untuk menjalankan perintah search guna mengkueri data menggunakan indeks pencarian. Untuk informasi selengkapnya, lihat Search index.

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

   search -n search_index --return_all_indexed

2. Kode contoh berikut menunjukkan cara memasukkan kondisi kueri sesuai permintaan 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 Tablestore SDK for Java, Tablestore SDK for Go, Tablestore SDK for Python, Tablestore SDK for Node.js, Tablestore SDK for .NET, dan Tablestore SDK for PHP. Pada contoh berikut, Tablestore SDK for Java digunakan untuk menjelaskan cara menjalankan kueri jarak geografis.

Kode contoh berikut menunjukkan cara mengkueri baris-baris yang nilai kolom Col_GeoPoint-nya 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 yang lebih besar 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 dikembalikan atau menentukan bahwa semua kolom dikembalikan. Jika Anda tidak menentukan parameter ini, hanya kolom kunci primer 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 dikembalikan. 
    //searchRequest.setColumnsToGet(columnsToGet);

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