All Products
Search
Document Center

Tablestore:Kueri poligon geografis

Last Updated:Sep 21, 2026

Kueri poligon geografis memungkinkan Anda menentukan area geografis berbentuk poligon sebagai kondisi kueri. Tablestore mengembalikan baris-baris yang nilai bidang yang ditentukan 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 latitude,longitude. Nilai valid untuk latitude: [-90,+90]. Nilai valid untuk longitude: [-180,+180]. Contoh: 35.8,-45.91.

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 Konsol Tablestore

  1. Buka tab Index Management.

    1. Login ke Konsol Tablestore.

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

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

    4. Pada tab Instance Details, di tab Data Table List, klik nama tabel data atau klik Index Management di kolom Tindakan.

  2. Pada tab Index Management, temukan Indeks Pencarian target dan klik Search di kolom Actions.

  3. Pada kotak dialog Search, konfigurasikan 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 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 GeoPolygonQuery. Masukkan koordinat geografis untuk titik-titik sudut poligon.

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

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

  4. Klik OK.

    Hasil kueri ditampilkan pada tab Index Management.

Gunakan CLI Tablestore

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

  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. Masukkan kondisi kueri sesuai permintaan sistem:

    {
        "Offset": -1,
        "Limit": 10,
        "Collapse": null,
        "Sort": null,
        "GetTotalCount": true,
        "Token": null,
        "Query": {
            "Name": "GeoPolygonQuery",
            "Query": {
                "FieldName": "col_geopoint",
                "Points": ["0,0","5,5","5,0"]
            }
        }
    }

Gunakan SDK Tablestore

Anda dapat menjalankan kueri poligon 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 poligon geografis.

Contoh berikut mengkueri baris-baris yang bidang location-nya berada di dalam poligon yang didefinisikan oleh titik-titik koordinat -1,-1, -1,2, 2,2, dan 2,-1.

GeoPolygonQuery geoPolygonQuery = new GeoPolygonQuery();
geoPolygonQuery.setFieldName("location");
geoPolygonQuery.setPoints(
        Arrays.asList("-1,-1", "-1,2", "2,2", "2,-1"));

SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(geoPolygonQuery);

Penagihan

Mengkueri data menggunakan Indeks Pencarian mengonsumsi throughput baca. Untuk informasi selengkapnya, lihat Metering dan penagihan Indeks Pencarian.

FAQ

Referensi