調用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 | 是 | 時間軸標識。 | |
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 | 否 | 指定讀取部分資料列。 |
響應訊息結構
message GetTimeseriesDataResponse {
required bytes rows_data = 1;
optional bytes next_token = 2;
}
名稱 | 類型 | 描述 |
rows_data | bytes | 返回的時序資料。 |
next_token | bytes | 用於擷取剩餘資料的標識。 |
使用SDK
您可以使用如下語言的SDK查詢時序資料。