全部产品
Search
文档中心

Tablestore:ScanQuery

更新时间:Jul 02, 2025

ScanQuery mendefinisikan konfigurasi pemindaian yang diatur saat menjalankan operasi ParallelScan.

Struktur data

message ScanQuery {
    optional Query query = 1;
    optional int32 limit = 2;
    optional int32 alive_time = 3;  //satuan adalah detik
    optional bytes token = 4;
    optional int32 current_parallel_id = 5;
    optional int32 max_parallel = 6;
}

Parameter

Tipe

Diperlukan

Deskripsi

query

Query

Ya

Kondisi kueri. Metode kueri berikut didukung: kueri tepat, kueri kabur, kueri berdasarkan rentang, kueri berdasarkan lokasi geografis, dan kueri bersarang.

limit

int32

Tidak

Jumlah maksimum baris yang dapat dikembalikan oleh setiap panggilan ParallelScan.

alive_time

int32

Tidak

Masa berlaku tugas pemindaian paralel saat ini. Masa berlaku ini juga merupakan masa berlaku token. Nilai default: 60. Satuan: detik. Kami menyarankan Anda menggunakan nilai default.

Jika permintaan berikutnya tidak dilakukan dalam masa berlaku, data tambahan tidak dapat di-query. Waktu validitas token diperbarui setiap kali Anda mengirimkan permintaan.

token

bytes

Tidak

Token yang digunakan untuk membagi hasil kueri menjadi halaman.

Hasil dari permintaan ParallelScan berisi token untuk halaman berikutnya. Anda dapat menggunakan token tersebut untuk mengambil halaman berikutnya.

current_parallel_id

int32

Ya

ID tugas pemindaian paralel dalam permintaan. Nilai valid: [0, max_parallel).

max_parallel

int32

Ya

Jumlah maksimum tugas pemindaian paralel per permintaan. Jumlah maksimum tugas pemindaian paralel per permintaan bervariasi tergantung pada volume data. Volume data yang lebih besar memerlukan lebih banyak tugas pemindaian paralel dalam satu sesi.

Operasi terkait

ParallelScan