GetTimeseriesData
調(diào)用GetTimeseriesData接口查詢某個時間線的數(shù)據(jù)。
請求消息結(jié)構(gòu)
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 | 是 | 時間線標識。 | |
begin_time | int64 | 否 | 開始時間。格式為微秒單位時間戳(從1970-01-01 00:00:00 UTC計算起的微秒數(shù))。 |
end_time | int64 | 否 | 結(jié)束時間。格式為微秒單位時間戳(從1970-01-01 00:00:00 UTC計算起的微秒數(shù))。 |
specific_time | int64 | 否 | 指定時間。格式為微秒單位時間戳(從1970-01-01 00:00:00 UTC計算起的微秒數(shù))。 |
token | bytes | 否 | 用于繼續(xù)獲取剩余數(shù)據(jù)的標識。 |
limit | int32 | 否 | 最多返回的行數(shù)限制。 |
backward | bool | 否 | 是否按照時間倒序讀取。默認為正序讀取。 |
fields_to_get | 否 | 指定讀取部分數(shù)據(jù)列。 | |
supported_table_version | int64 | 否 | SDK支持的時序表模型版本號。取值范圍如下:
不同版本之間的TimeseriesKey數(shù)據(jù)結(jié)構(gòu)有所不同,supported_table_version低于操作的時序表模型版本會返回錯誤。 |
響應消息結(jié)構(gòu)
message GetTimeseriesDataResponse {
required bytes rows_data = 1;
optional bytes next_token = 2;
}
名稱 | 類型 | 描述 |
rows_data | bytes | 返回的時序數(shù)據(jù)。 |
next_token | bytes | 用于獲取剩余數(shù)據(jù)的標識。 |
使用SDK
您可以使用如下語言的SDK查詢時序數(shù)據(jù)。