全部产品
Search
文档中心

Tablestore:Kueri match all

更新时间:Jul 06, 2025

Gunakan kueri match all untuk mencocokkan semua baris dalam tabel, menanyakan jumlah total baris, atau mengembalikan beberapa baris acak.

Prasyarat

Parameter

Parameter

Deskripsi

table_name

Nama tabel data.

index_name

Nama indeks pencarian.

offset

Posisi dari mana kueri saat ini dimulai.

limit

Jumlah maksimum baris yang ingin Anda kueri saat ini kembalikan.

Untuk hanya menanyakan jumlah baris yang memenuhi kondisi kueri tanpa mengembalikan data spesifik, Anda dapat menetapkan Limit ke 0. Dengan cara ini, Tablestore mengembalikan jumlah baris yang memenuhi kondisi kueri tanpa data spesifik dari tabel.

get_total_count

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

Jika parameter ini disetel ke true, performa kueri akan terpengaruh.

collapse

Menentukan bahwa hasil yang dikembalikan dirangkum berdasarkan kolom tertentu.

query_type

Tipe kueri. Untuk menggunakan kueri match, atur parameter ini ke QueryTypeConst::MATCH_ALL_QUERY.

sort

Metode yang ingin Anda gunakan untuk mengurutkan baris dalam respons. Untuk informasi lebih lanjut, lihat Pengurutan dan paging.

columns_to_get

Menentukan apakah akan mengembalikan semua kolom setiap baris yang memenuhi kondisi kueri. Anda dapat mengonfigurasi return_type dan return_names untuk parameter ini.

  • Jika Anda menetapkan return_type ke ColumnReturnTypeConst::RETURN_SPECIFIED, Anda dapat menggunakan return_names untuk menentukan kolom yang akan dikembalikan.

  • Jika Anda menetapkan parameter return_type ke ColumnReturnTypeConst::RETURN_ALL, semua kolom akan dikembalikan.

  • Jika Anda menetapkan return_type ke ColumnReturnTypeConst::RETURN_ALL_FROM_INDEX, semua kolom dalam indeks pencarian akan dikembalikan.

  • Jika Anda menetapkan parameter return_type ke ColumnReturnTypeConst::RETURN_NONE, hanya kolom kunci utama yang akan dikembalikan.

Contoh

Berikut adalah contoh kode yang menggunakan indeks pencarian untuk mendapatkan hingga 10 rekaman kata kunci unik dari tabel php_sdk_test dan mengembalikan data di kolom col1 dan col2.

$request = array(
    'table_name' => 'php_sdk_test',
    'index_name' => 'php_sdk_test_search_index',
    'search_query' => array(
        'offset' => 0,
        'limit' => 10,
        'get_total_count' => true,
        'collapse' => array(
            'field_name' => 'keyword'
        ),
        'query' => array(
            'query_type' => QueryTypeConst::MATCH_ALL_QUERY
        ),
//        'sort' => array(// Tentukan metode pengurutan tertentu jika diperlukan. 
//            array(
//                'field_sort' => array(
//                    'field_name' => 'keyword',
//                    'order' => SortOrderConst::SORT_ORDER_ASC
//                )
//            ),
//        ),
        'token' => null,
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('col1', 'col2')
    )
);
$response = $otsClient->search($request);

FAQ

Bagaimana cara menanyakan jumlah total baris dalam sebuah tabel?

Referensi

  • Saat menggunakan indeks pencarian untuk menanyakan data, Anda dapat memanfaatkan metode kueri berikut: kueri tepat, kueri terms, kueri match all, kueri match, kueri match phrase, kueri prefix, kueri range, kueri wildcard, kueri Boolean, kueri geo, kueri nested, dan kueri exists. Gunakan metode kueri ini sesuai dengan kebutuhan bisnis Anda untuk menanyakan data dari berbagai dimensi.

    Untuk mengurutkan atau membagi halaman hasil kueri, gunakan fitur Pengurutan dan paging. Untuk informasi lebih lanjut, lihat Pengurutan dan paging.

    Untuk merangkum set hasil berdasarkan kolom tertentu, gunakan fitur collapse (distinct). Dengan fitur ini, data tipe tertentu hanya muncul sekali dalam hasil kueri. Untuk detail lebih lanjut, lihat Collapse (distinct).

  • Untuk analisis data seperti nilai ekstrem, jumlah, atau total baris, gunakan operasi agregasi atau jalankan pernyataan SQL. Untuk informasi lebih lanjut, lihat Agregasi dan Kueri SQL.

  • Untuk mendapatkan semua baris yang memenuhi kondisi kueri tanpa pengurutan, gunakan fitur pemindaian paralel melalui operasi ParallelScan dan ComputeSplits. Untuk detail lebih lanjut, lihat Pemindaian paralel.