TableInBatchGetRowRequest
在BatchGetRow操作中TableInBatchGetRowRequest表示單個讀取表數(shù)據(jù)的配置。
數(shù)據(jù)結(jié)構(gòu)
message TableInBatchGetRowRequest {
required string table_name = 1;
repeated bytes primary_key = 2; //由Plainbuffer編碼。
repeated bytes token = 3;
repeated string columns_to_get = 4; // 不指定則讀出所有的列。
optional TimeRange time_range = 5;
optional int32 max_versions = 6;
optional bytes filter = 8;
optional string start_column = 9;
optional string end_column = 10;
}
名稱 | 類型 | 是否必須 | 描述 |
table_name | string | 是 | 數(shù)據(jù)表名稱。 |
primary_key | bytes | 是 | 指定行全部的主鍵列,包含主鍵名和主鍵值,由Plainbuffer編碼。更多信息,請參見Plainbuffer。 |
token | bytes | 否 | 寬行讀取時指定下一次讀取的起始位置,暫不可用。 |
columns_to_get | string | 否 | 要返回的全部列名。 |
time_range | 和max_versions必須至少存在一個 | 讀取版本號范圍或特定版本號的數(shù)據(jù)。 時間戳的單位是毫秒,取值范圍為0到INT64.MAX。
| |
max_versions | int32 | 和time_range必須至少存在一個 | 最多讀取的版本數(shù)。 如果指定max_versions為2,則每一列最多返回2個版本的數(shù)據(jù)。 |
filter | bytes | 否 | 過濾條件表達式。Filter經(jīng)過protobuf序列化后的二進制數(shù)據(jù)。 |
start_column | string | 否 | 指定讀取時的起始列,主要用于寬行讀。
如果一張表有"a"、"b"、"c"三列,讀取時指定start_column為“b”,則會從"b"列開始讀,返回"b","c"兩列。 |
end_column | string | 否 | 指定讀取時的結(jié)束列,主要用于寬行讀。
如果一張表有"a"、"b"、"c"三列,讀取時指定end_column為“b”,則讀到"b"列時會結(jié)束,返回"a"列。 |