全部產品
Search
文件中心

Tablestore:TableInBatchGetRowRequest

更新時間:Jul 05, 2024

在BatchGetRow操作中TableInBatchGetRowRequest表示單個讀取表資料的配置。

資料結構

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

資料表名稱。

primary_key

bytes

指定行全部的主鍵列,包含主鍵名和主索引值,由Plainbuffer編碼。更多資訊,請參見Plainbuffer

token

bytes

寬行讀取時指定下一次讀取的起始位置,暫不可用。

columns_to_get

string

要返回的全部列名。

time_range

TimeRange

和max_versions必須至少存在一個

讀取版本號碼範圍或特定版本號碼的資料。

時間戳記的單位是毫秒,取值範圍為0到INT64.MAX。

  • 如果要查詢一個範圍的資料,則需要設定start_time和end_time。start_time和end_time分別表示起始時間戳記和結束時間戳記,範圍為前閉後開區間,即[ start_time, end_time)

  • 如果要查詢特定版本號碼的資料,則需要設定specific_time。specific_time表示特定的時間戳記。

max_versions

int32

和time_range必須至少存在一個

最多讀取的版本數。

如果指定max_versions為2,則每一列最多返回2個版本的資料。

filter

bytes

過濾條件運算式。Filter經過protobuf序列化後的位元據。

start_column

string

指定讀取時的起始列,主要用於寬行讀。

  • 返回的結果中包含當前起始列。

  • 列的順序按照列名的字典序排序。

如果一張表有"a"、"b"、"c"三列,讀取時指定start_column為“b”,則會從"b"列開始讀,返回"b","c"兩列。

end_column

string

指定讀取時的結束列,主要用於寬行讀。

  • 返回的結果中不包含當前結束列。

  • 列的順序按照列名的字典序排序。

如果一張表有"a"、"b"、"c"三列,讀取時指定end_column為“b”,則讀到"b"列時會結束,返回"a"列。

相關操作

BatchGetRow