掃描時序資料 - Tablestore

調用ScanTimeseriesData介面掃描時序資料。

請求訊息結構

message ScanTimeseriesDataRequest {
  required string table_name = 1;
  optional bytes split_info = 2;
  optional int64 start_time_us = 3;
  optional int64 end_time_us = 4;
  repeated TimeseriesFieldsToGet fields_to_get = 5;
  optional int32 limit = 6;
  optional RowsSerializeType data_serialize_type = 7;
  optional bytes token = 8;
  optional int64 supported_table_version = 9;
}

名稱	類型	是否必選	描述
table_name	string	是	時序表名稱。
split_info	bytes	否	通過SplitTimeseriesScanTask介面返回的SplitInfo。
start_time_us	int64	否	開始時間。格式為微秒單位時間戳記（從1970-01-01 00:00:00 UTC計算起的微秒數）。
end_time_us	int64	否	結束時間。格式為微秒單位時間戳記（從1970-01-01 00:00:00 UTC計算起的微秒數）。
fields_to_get	repeated TimeseriesFieldsToGet	否	指定讀取部分資料列。
limit	int32	否	每次最多返回的行數，最大值為5000，預設值為5000。
data_serialize_type	RowsSerializeType	否	時序資料的行序列化類別型。
token	bytes	否	用於繼續擷取剩餘資料的標識。
supported_table_version	int64	否	SDK中支援的時序表模型版本號碼。取值範圍如下： 0（預設）：不支援包含自訂時間軸標識或作為主鍵的資料欄位的時序表。 1：支援包含自訂時間軸標識或作為主鍵的資料欄位的時序表。說明不同版本號碼會導致TimeseriesKey資料結構的差異。如果SDK中的版本號碼低於待操作的時序表模型版本號碼，將會導致錯誤。如果您需自行開發Tablestore SDK，建議將其取值設定為固定值`1`。

響應訊息結構

message ScanTimeseriesDataResponse {
  optional RowsSerializeType data_serialize_type = 1;
  required bytes data = 2;
  optional bytes next_token = 3;
}

名稱	類型	是否必選	描述
data_serialize_type	RowsSerializeType	否	時序資料的行序列化類別型。
data	bytes	是	返回的時序資料。
next_token	bytes	否	用於擷取剩餘資料的標識。