調用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查詢時序資料。