全部產品
Search
文件中心

Tablestore:ScanTimeseriesData

更新時間:Jul 24, 2024

調用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;
}

名稱

類型

是否必選

描述

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

用於繼續擷取剩餘資料的標識。

響應訊息結構

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

用於擷取剩餘資料的標識。