Bir BatchGetRow işlemi kapsamında tek bir tablodan veri okumak için gereken yapılandırmayı belirtir.
Veri yapısı
message TableInBatchGetRowRequest {
required string table_name = 1;
repeated bytes primary_key = 2; // Encoded using Plainbuffer.
repeated bytes token = 3;
repeated string columns_to_get = 4; // If not specified, all columns are read.
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 |
Veri tablosunun adı. |
|
primary_key |
bytes |
Yes |
Belirtilen satırın birincil anahtar sütunları (adlar ve değerler dahil). Sütunlar Plainbuffer kullanılarak kodlanır. Daha fazla bilgi için bkz. Plainbuffer. |
|
token |
bytes |
No |
Geniş satır okuma işleminde sonraki okumanın başlangıç konumu. Bu parametre şu anda kullanılamamaktadır. |
|
columns_to_get |
string |
No |
Döndürülecek sütunların adları. Belirtilmezse tüm sütunlar döndürülür. |
|
time_range |
Bu parametre veya max_versions belirtilmelidir. |
Okunacak sürüm aralığı veya belirli sürüm. Zaman damgaları milisaniye cinsindendir ve [0, INT64.MAX] aralığında olmalıdır.
|
|
|
max_versions |
int32 |
Bu parametre veya time_range belirtilmelidir. |
Sütun başına döndürülecek maksimum sürüm sayısı. Örneğin, bu değer 2 olarak ayarlanırsa her sütun için en fazla iki sürüm döndürülür. |
|
filter |
bytes |
No |
Filtre koşulu. Bu, protobuf kullanılarak kodlanmış bir Filter nesnesinin ikili serileştirilmiş halidir. |
|
start_column |
string |
No |
Okuma işlemi için başlangıç sütunu; öncelikle geniş satır okumalarında kullanılır. Sütunlar ada göre sözlük sırasına göre sıralanır ve sonuç başlangıç sütununu içerir. Örneğin, bir tabloda a, b ve c sütunları varsa ve start_column değerini b olarak ayarlarsanız b ve c sütunları döndürülür. |
|
end_column |
string |
No |
Okuma işlemi için bitiş sütunu; öncelikle geniş satır okumalarında kullanılır. Sütunlar ada göre sözlük sırasına göre sıralanır ve sonuç bitiş sütununu içermez. Örneğin, bir tabloda a, b ve c sütunları varsa ve end_column değerini b olarak ayarlarsanız yalnızca a sütunu döndürülür. |