調用GetTimeseriesData查詢某個時間軸的資料 - Tablestore

調用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;
  optional int64 supported_table_version = 10;
}

名稱	類型	是否必選	描述
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	否	指定讀取部分資料列。
supported_table_version	int64	否	SDK支援的時序表模型版本號碼。取值範圍如下： 0（預設）：不支援包含自訂時間軸標識或作為主鍵的資料欄位的時序表。 1：支援包含自訂時間軸標識和作為主鍵的資料欄位的時序表。不同版本之間的TimeseriesKey資料結構有所不同，supported_table_version低於操作的時序表模型版本會返回錯誤。

響應訊息結構

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

名稱	類型	描述
rows_data	bytes	返回的時序資料。
next_token	bytes	用於擷取剩餘資料的標識。

使用SDK

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