调用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查询时序数据。