文档

QueryTimeseriesMeta

更新时间:

调用QueryTimeseriesMeta接口检索时间线元数据。

请求消息结构

message QueryTimeseriesMetaRequest {
  required string table_name = 1;
  optional MetaQueryCondition condition = 2;
  optional bool get_total_hit = 3;
  optional bytes token = 4;
  optional int32 limit = 5;
  optional int64 supported_table_version = 6;
}

名称

类型

是否必选

描述

table_name

string

时序表名。

condition

MetaQueryCondition

时间线检索条件。

get_total_hit

bool

是否获取符合条件总行数。

token

bytes

用于继续获取剩余数据的标识。

limit

int32

最多返回的行数限制。

supported_table_version

int64

SDK支持的时序表模型版本号。取值范围如下:

  • 0(默认):不支持包含自定义时间线标识或作为主键的数据字段的时序表。

  • 1:支持包含自定义时间线标识和作为主键的数据字段的时序表。

不同版本之间的TimeseriesKey数据结构有所不同,supported_table_version低于操作的时序表模型版本会返回错误。

响应消息结构

message QueryTimeseriesMetaResponse {
  repeated TimeseriesMeta timeseries_metas = 1;
  optional int64 total_hit = 2;
  optional bytes next_token = 3;
}

名称

类型

描述

timeseries_metas

TimeseriesMeta

时间线元数据列表。

total_hit

int64

符合条件总行数。

next_token

bytes

用于获取剩余数据的标识。

使用SDK

您可以使用如下语言的SDK检索时间线。