全部產品
Search
文件中心

Tablestore:GetTimeseriesData

更新時間:Jul 27, 2024

調用GetTimeseriesData介面查詢某個時間軸的資料。

請求訊息結構

message GetTimeseriesDataRequest {
  required string table_name = 1;
  required TimeseriesKey time_series_key = 2;
  optional int64 begin_time = 3;
  optional int64 end_time = 4;
  optional int64 specific_time = 5; // not used
  optional bytes token = 6; // bytes
  optional int32 limit = 7;
  optional bool backward = 8;
  repeated TimeseriesFieldsToGet fields_to_get = 9;
}

名稱

類型

是否必選

描述

table_name

string

時序表名。

time_series_key

TimeseriesKey

時間軸標識。

begin_time

int64

開始時間。格式為微秒單位時間戳記(從1970-01-01 00:00:00 UTC計算起的微秒數)。

end_time

int64

結束時間。格式為微秒單位時間戳記(從1970-01-01 00:00:00 UTC計算起的微秒數)。

specific_time

int64

指定時間。格式為微秒單位時間戳記(從1970-01-01 00:00:00 UTC計算起的微秒數)。

token

bytes

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

limit

int32

最多返回的行數限制。

backward

bool

是否按照時間倒序讀取。預設為正序讀取。

fields_to_get

TimeseriesFieldsToGet

指定讀取部分資料列。

響應訊息結構

message GetTimeseriesDataResponse {
  required bytes rows_data = 1;
  optional bytes next_token = 2;
}

名稱

類型

描述

rows_data

bytes

返回的時序資料。

next_token

bytes

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

使用SDK

您可以使用如下語言的SDK查詢時序資料。