All Products
Search
Document Center

Tablestore:TableInBatchGetRowRequest

Last Updated:Apr 30, 2026

Menentukan konfigurasi untuk membaca data dari satu tabel dalam operasi BatchGetRow.

Struktur data

message TableInBatchGetRowRequest {
    required string table_name = 1;
    repeated bytes primary_key = 2; // Dikodekan menggunakan Plainbuffer.
    repeated bytes token = 3;
    repeated string columns_to_get = 4;  // Jika tidak ditentukan, semua kolom 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;
}

Name

Type

Required

Description

table_name

string

Yes

Nama tabel data.

primary_key

bytes

Yes

Kolom kunci primer untuk baris yang ditentukan, termasuk nama dan nilainya. Kolom-kolom tersebut dikodekan menggunakan Plainbuffer. Untuk informasi selengkapnya, lihat Plainbuffer.

token

bytes

No

Posisi awal untuk pembacaan berikutnya dalam pembacaan wide row. Parameter ini saat ini belum tersedia.

columns_to_get

string

No

Nama kolom yang akan dikembalikan. Jika tidak ditentukan, semua kolom dikembalikan.

time_range

TimeRange

Salah satu parameter ini atau max_versions harus ditentukan.

Rentang versi atau versi spesifik yang akan dibaca. Timestamp dalam milidetik dan harus berada dalam rentang [0, INT64.MAX].

  • Untuk membaca data dalam rentang versi, atur start_time dan end_time. Rentang tersebut bersifat half-open: [start_time, end_time).

  • Untuk membaca versi tertentu, atur specific_time.

max_versions

int32

Salah satu parameter ini atau time_range harus ditentukan.

Jumlah maksimum versi yang dikembalikan per kolom. Misalnya, jika diatur ke 2, paling banyak dua versi dikembalikan untuk setiap kolom.

filter

bytes

No

Kondisi filter. Ini adalah bentuk biner yang telah diserialisasi dari objek Filter yang dikodekan menggunakan protobuf.

start_column

string

No

Kolom awal untuk operasi baca, terutama digunakan dalam pembacaan wide row. Kolom diurutkan secara leksikografis berdasarkan nama, dan hasilnya mencakup kolom awal tersebut.

Misalnya, jika sebuah tabel memiliki kolom a, b, dan c, dan Anda mengatur start_column ke b, maka kolom b dan c dikembalikan.

end_column

string

No

Kolom akhir untuk operasi baca, terutama digunakan dalam pembacaan wide row. Kolom diurutkan secara leksikografis berdasarkan nama, dan hasilnya tidak mencakup kolom akhir tersebut.

Misalnya, jika sebuah tabel memiliki kolom a, b, dan c, dan Anda mengatur end_column ke b, hanya kolom a yang dikembalikan.

Operasi terkait

BatchGetRow