› 推特 ›阿里云技术文档›正文

多值查询最新数据点_多值查询_HTTP API 参考_时序数据库 TSDB_时序时空数据库TSDB

admin 阿里云技术文档 2020-02-11 221 0
阿里云服务器优惠

多值查询最新数据点

多值模型最新数据点查询（新建mlast）

请求路径和方法

请求路径 请求方法 描述
/api/query/mlast POST 获得多值模型指标数据中 fields 最新写入的数据点

请求内容

名称 类型 是否必需 描述 默认值 举例
queries Array 是 子查询数组。 无 见子查询说明
timestamp Long 否 unix 时间戳，单位为秒或者毫秒，指定该参数时表示查询到该时间戳为止最新的数据点，否则表示查询当前最新的数据点 Tags。这个是和 queries 相同级别参数，详情见示例。 无 1539763573
tupleFormat Boolean 否 将查询 fields 的最新数据点元组结构返回，详情见示例。 false false
tupleOffset Long 否 数据分页时返回的tuple的偏移量。仅在tupleFormat为true时有效。 0 5
tupleLimit Long 否 数据分页时返回的tuple最大数量。仅在tupleFormat为true时有效。 0 100

注意：/api/query/mlast 只能用于多值模型数据，单值模型数据的最新数据点，请使用 /api/query/last 接口。

子查询JSON格式

名称 类型 是否必需 描述 默认值 举例
metric String 是 待查询最新数据点的 Metric。 无 wind
fields List 是 需要查询最新数据点的域, “*”代表查询 metric 下所有域。 无 {speed, level, description}
tags String 否 待查询最新数据点的 Tags。 无 sensor = IOTE_1988_0001

请求 JSON 示例

任务：查询 “cpu” 指标下，标签为 “host_name=host1” 的 “usage_system” 和 “usage_idle” 域最新写入数据点。请求： POST/api/query/mlast请求体：

  1.     {
  2.         "tupleFormat": true,
  3.         "tupleOffset":5,
  4.         "tupleLimit":100,
  5.         "timestamp" : 1551851846,
  6.         "queries": [
  7.             {
  8.                 "metric": "cpu",
  9.                 "fields": ["usage_system", "usage_idle"],
  10.                 "tags": {
  11.                     "host_name": "host1"
  12.                 }
  13.             }
  14.         ]
  15.     }

响应说明

查询成功的 HTTP 响应码为 200，返回符合条件的时间线最新数据点，内容为JSON 格式数据；如果没有时间线满足条件，则返还空集。JSON说明如下：

名称 描述
metric 指标名
columns 返回结果集中的列名称，包括时间戳和查询的域名称
tags 数据点对应的tag键值集合
values 查询指标域的值，值的顺序和 columns 的顺序对应

注意 如果将 tupleFormat 设置成 false，增返回结果格式跟单值模型一致。这种场景下的详细响应内容可以参考 /api/query/last 接口的介绍。

返回结果 JSON 示例

  1. [
  2.   {
  3.     "metric": "wind",
  4.     "columns": [
  5.       "timestamp",
  6.       "level",
  7.       "speed"
  8.     ],
  9.     "tags": {
  10.       "city": "hangzhou",
  11.       "country": "china",
  12.       "province": "zhejiang",
  13.       "sensor": "IOTE_8859_0001"
  14.     },
  15.     "values": [
  16.       [1346846405000, 5.1, 45.1]
  17.     ]
  18.   }
  19. ]
版权声明

本文仅代表作者观点，不代表本站立场。
本文系作者授权发表，未经许可，不得转载。

评论

-----