Tablestore：Kueri kotak pembatas 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 Anda kelola atau klik Manage Instance di kolom Actions instance.

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

2. Di tab Indexes, temukan indeks pencarian yang ingin Anda gunakan untuk mengkueri data 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 atribut tertentu, matikan All Columns dan tentukan kolom atribut yang ingin Anda kembalikan. Pisahkan beberapa kolom atribut dengan koma (,).

      Catatan

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

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

      Jika Anda memilih operator logika And, data yang memenuhi kondisi kueri akan dikembalikan. Jika Anda memilih operator Or dan menentukan satu kondisi kueri, data yang memenuhi kondisi kueri akan dikembalikan. Jika Anda memilih operator logika Or dan menentukan beberapa kondisi kueri, data yang memenuhi salah satu kondisi kueri akan dikembalikan. Jika Anda memilih operator logika Not, data yang tidak memenuhi kondisi kueri akan dikembalikan.

   3. Pilih bidang indeks bertipe data GEOPOINT dan klik Add.

   4. Setel tipe kueri bidang indeks ke GeoBoundingBoxQuery dan masukkan serta pilih pasangan koordinat pojok kiri atas dan pasangan koordinat pojok kanan bawah area geografis persegi panjang.

   5. Secara default, fitur pengurutan dinonaktifkan. Jika Anda ingin mengurutkan hasil kueri berdasarkan bidang tertentu, aktifkan Sort dan tentukan bidang berdasarkan mana Anda ingin mengurutkan hasil kueri dan urutan pengurutan.

   6. Secara default, fitur agregasi dinonaktifkan. Jika Anda ingin mengumpulkan statistik pada bidang tertentu, aktifkan Collect Statistics, tentukan bidang berdasarkan mana Anda ingin mengumpulkan statistik, dan kemudian konfigurasikan informasi yang diperlukan untuk mengumpulkan statistik.

4. Klik OK.

   Data yang memenuhi kondisi kueri ditampilkan dalam urutan tertentu di tab Indexes.

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

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

   search -n search_index --return_all_indexed

2. Berikut ini adalah contoh kode sampel yang menunjukkan cara memasukkan kondisi kueri seperti yang dipromosikan oleh sistem:

   {
       "Offset": -1,
       "Limit": 10,
       "Collapse": null,
       "Sort": null,
       "GetTotalCount": true,
       "Token": null,
       "Query": {
           "Name": "GeoBoundingBoxQuery",
           "Query": {
               "FieldName": "col_geopoint",
               "TopLeft": "10,0",
               "BottomRight": "0,10"
           }
       }
   }

Anda dapat menjalankan kueri kotak pembatas 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. Pada contoh berikut, SDK Tablestore untuk Java digunakan untuk menjelaskan cara menjalankan kueri kotak pembatas geografis.

Berikut ini adalah contoh kode sampel yang menunjukkan cara mengkueri baris di mana nilai kolom Col_GeoPoint berada dalam area geografis persegi panjang yang didefinisikan oleh pojok kiri atas "10,0" dan pojok kanan bawah "0,10":

public static void geoBoundingBoxQuery(SyncClient client) {
    SearchQuery searchQuery = new SearchQuery();
    GeoBoundingBoxQuery geoBoundingBoxQuery = new GeoBoundingBoxQuery(); // Gunakan GeoBoundingBoxQuery.
    geoBoundingBoxQuery.setFieldName("Col_GeoPoint"); // Tentukan nama kolom yang ingin Anda kueri.
    geoBoundingBoxQuery.setTopLeft("10,0"); // Tentukan koordinat pojok kiri atas area geografis persegi panjang.
    geoBoundingBoxQuery.setBottomRight("0,10"); // Tentukan koordinat pojok kanan bawah area geografis persegi panjang.
    searchQuery.setQuery(geoBoundingBoxQuery);
    //searchQuery.setGetTotalCount(true); // Setel 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());
}