All Products
Search

This Product

    Tablestore:Match all query

    Document Center

    Tablestore:Match all query

    Last Updated:Sep 19, 2026

    Anda dapat menggunakan match all query untuk mencocokkan semua baris dalam sebuah tabel guna mengetahui jumlah total baris di tabel tersebut atau mengembalikan beberapa baris acak.

    Operasi API

    Anda dapat memanggil operasi Search atau ParallelScan dan mengatur jenis kueri ke MatchAllQuery untuk melakukan match all query.

    Parameter

    Parameter

    Deskripsi

    query

    Jenis kueri. Atur parameter query ke MatchAllQuery.

    tableName

    Nama tabel data.

    indexName

    Nama search index.

    limit

    Jumlah maksimum baris yang ingin dikembalikan oleh kueri saat ini.

    Jika Anda ingin kueri saat ini mengembalikan beberapa baris data acak, atur parameter limit ke bilangan bulat positif.

    Untuk hanya mengetahui jumlah baris yang memenuhi kondisi kueri tanpa data spesifik, atur parameter limit ke 0.

    columnsToGet

    Menentukan apakah semua kolom dari setiap baris yang memenuhi kondisi kueri akan dikembalikan. Anda dapat menentukan bidang returnAll dan columns untuk parameter columnsToGet.

    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 akan dikembalikan.

    getTotalCount

    Menentukan apakah jumlah total baris yang memenuhi kondisi kueri akan dikembalikan. Nilai default parameter ini adalah false, yang berarti jumlah total baris yang memenuhi kondisi kueri tidak dikembalikan.

    Jika Anda mengatur parameter ini ke true, performa kueri akan menurun.

    Metode

    Anda dapat menggunakan Tablestore CLI atau SDK Tablestore untuk melakukan match all query. Sebelum menjalankan match all query, pastikan persiapan berikut telah dilakukan:

    Gunakan Tablestore CLI

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

    1. Jalankan perintah search untuk menggunakan search index bernama 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:

      {
    "Offset": -1,
    "Limit": 10,
    "Collapse": null,
    "Sort": null,
    "GetTotalCount": true,
    "Token": null,
    "Query": {
        "Name": "MatchAllQuery",
        "Query": {
        }
    }
}

    Gunakan SDK Tablestore

    Anda dapat melakukan match all query menggunakan SDK Tablestore berikut: 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 ini, digunakan Tablestore SDK for Java.

    Contoh berikut mencocokkan setiap baris dalam search index dan mengembalikan hingga 10 baris serta jumlah total baris yang cocok.

    String tableName = "example_table";
String indexName = "example_index";

SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(new MatchAllQuery());
searchQuery.setLimit(10);
searchQuery.setTrackTotalCount(SearchQuery.TRACK_TOTAL_COUNT);

SearchRequest request = new SearchRequest(tableName, indexName, searchQuery);
SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
columnsToGet.setReturnAll(true);
request.setColumnsToGet(columnsToGet);

SearchResponse response = client.search(request);
System.out.println(response.getTotalCount());
System.out.println(response.getRows());

    Penagihan

    Mengkueri data menggunakan Search Index mengonsumsi throughput baca. Untuk informasi selengkapnya, lihat Pengukuran dan penagihan Search Index.

    FAQ

    Bagaimana cara mengkueri jumlah total baris dalam tabel?

    Referensi