調用ScanTimeseriesData接口掃描時序數據。
請求消息結構
message ScanTimeseriesDataRequest {
required string table_name = 1;
optional bytes split_info = 2;
optional int64 start_time_us = 3;
optional int64 end_time_us = 4;
repeated TimeseriesFieldsToGet fields_to_get = 5;
optional int32 limit = 6;
optional RowsSerializeType data_serialize_type = 7;
optional bytes token = 8;
optional int64 supported_table_version = 9;
}
名稱 | 類型 | 是否必選 | 描述 |
table_name | string | 是 | 時序表名。 |
split_info | bytes | 否 | 通過SplitTimeseriesScanTask接口返回的SplitInfo。 |
start_time_us | int64 | 否 | 開始時間。格式為微秒單位時間戳(從1970-01-01 00:00:00 UTC計算起的微秒數)。 |
end_time_us | int64 | 否 | 結束時間。格式為微秒單位時間戳(從1970-01-01 00:00:00 UTC計算起的微秒數)。 |
fields_to_get | repeated TimeseriesFieldsToGet | 否 | 指定讀取部分數據列。 |
limit | int32 | 否 | 每次最多返回的行數,最大值為5000,默認值為5000。 |
data_serialize_type | 否 | 時序數據的行序列化類型。 | |
token | bytes | 否 | 用于繼續(xù)獲取剩余數據的標識。 |
supported_table_version | int64 | 否 | SDK支持的時序表模型版本號。取值范圍如下:
不同版本之間的TimeseriesKey數據結構有所不同,supported_table_version低于操作的時序表模型版本會返回錯誤。 |
響應消息結構
message ScanTimeseriesDataResponse {
optional RowsSerializeType data_serialize_type = 1;
required bytes data = 2;
optional bytes next_token = 3;
}
名稱 | 類型 | 是否必選 | 描述 |
data_serialize_type | 否 | 時序數據的行序列化類型。 | |
data | bytes | 是 | 返回的時序數據。 |
next_token | bytes | 否 | 用于獲取剩余數據的標識。 |
文檔內容是否對您有幫助?