全部产品
Search
文档中心

Tablestore:TableInBatchGetRowRequest

更新时间:Jul 02, 2025

Menentukan konfigurasi tabel data yang akan dibaca.

Struktur Data

message TableInBatchGetRowRequest {
    required string table_name = 1;
    repeated bytes primary_key = 2; // Kolom kunci utama dikodekan dalam format PlainBuffer. 
    repeated bytes token = 3;
    repeated string columns_to_get = 4;  // Jika parameter ini tidak ditentukan, semua kolom akan dibaca. 
    optional TimeRange time_range = 5;
    optional int32 max_versions = 6;
    optional bytes filter = 8;
    optional string start_column = 9;
    optional string end_column = 10;
}

Parameter

Tipe

Diperlukan

Deskripsi

table_name

string

Ya

Nama tabel data.

primary_key

bytes

Ya

Semua kolom kunci utama dari baris yang datanya ingin Anda baca, termasuk nama dan nilai kolom kunci utama. Kolom kunci utama dikodekan dalam format PlainBuffer. Untuk informasi lebih lanjut, lihat PlainBuffer.

token

bytes

Tidak

Posisi dari mana operasi pembacaan kolom lebar berikutnya dimulai. Parameter ini tidak tersedia.

columns_to_get

string

Tidak

Nama semua kolom yang akan dikembalikan.

time_range

TimeRange

Anda harus mengonfigurasi setidaknya satu dari time_range dan max_versions.

Rentang versi atau versi spesifik yang ingin Anda baca.

Nilai parameter ini adalah timestamp dalam milidetik. Nilai valid: 0 hingga INT64.MAX.

  • Untuk menanyakan data yang versinya berada dalam rentang waktu tertentu, Anda harus mengonfigurasi start_time dan end_time. start_time menunjukkan timestamp awal. end_time menunjukkan timestamp akhir. Rentang yang ditentukan mencakup timestamp awal dan mengecualikan timestamp akhir.

  • Untuk menanyakan data versi tertentu, Anda harus mengonfigurasi specific_time. specific_time menunjukkan timestamp tertentu.

max_versions

int32

Anda harus mengonfigurasi setidaknya satu dari max_versions dan time_range.

Jumlah maksimum versi data yang dapat Anda baca.

Jika nilai max_versions adalah 2, maka paling banyak dua versi data akan dikembalikan untuk setiap kolom.

filter

bytes

Tidak

Ekspresi kondisi filter. Ekspresi kondisi filter diserialisasi sebagai data biner menggunakan Protobuf. Untuk informasi lebih lanjut, lihat Filter.

start_column

string

Tidak

Kolom tempat operasi pembacaan dimulai dalam satu baris. Parameter ini digunakan untuk membaca kolom lebar.

  • Respon berisi kolom awal yang ditentukan.

  • Kolom diurutkan berdasarkan nama mereka dalam urutan abjad.

Sebagai contoh, jika sebuah tabel berisi kolom "a", "b", dan "c", dan nilai start_column adalah "b", operasi pembacaan dimulai dari kolom "b", dan kolom "b" dan "c" dikembalikan.

end_column

string

Tidak

Kolom tempat operasi pembacaan berakhir dalam satu baris. Parameter ini digunakan untuk membaca kolom lebar.

  • Respon tidak berisi kolom akhir yang ditentukan.

  • Kolom diurutkan berdasarkan nama mereka dalam urutan abjad.

Sebagai contoh, jika sebuah tabel berisi kolom "a", "b", dan "c", dan nilai end_column adalah "b", operasi pembacaan berakhir pada kolom "b", dan hanya kolom "a" yang dikembalikan.

Referensi

BatchGetRow