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