云原生多模数据库 Lindorm 单值数据查询

请求路径和方法

请求内容 JSON 格式

时间戳单位判断

时间戳的单位可以是秒或者毫秒。时序引擎会通过数值大小来判断时间戳的单位，规则如下：

• 时间戳区间为 [4284768,9999999999]：判断为秒，表示的日期时间区间为： [1970-02-20 00:59:28, 2286-11-21 01:46:39]。
• 时间戳区间为 [10000000000,9999999999999]：判断为毫秒，表示的日期时间区间为： [1970-04-27 01:46:40.000, 2286-11-21 01:46:39.999]。
• 时间戳区间为（-∞,4284768）和（9999999999999,+∞）：判断为非法时间戳区间。

单时间点数据查询

时序引擎支持单时间点数据查询。您可以将开始时间和结束时间设置为相同的数值。例如，"start":1356998400，"end":1356998400。

子查询 JSON 格式

查询示例

请求：POST/api/query

请求体：

{
  "start": 1356998400,
  "end": 1356998460,
  "queries": [
    {
      "aggregator": "sum",
      "metric": "sys.cpu.0"
    },
    {
      "aggregator": "sum",
      "metric": "sys.cpu.1"
    }
  ]
}

数据分页查询（Limit 和 Offset） 说明

Limit：子查询返回数据点的最大数目。默认值是 0，代表不限制返回点数量。

Offset： 子查询返回数据点的偏移量。默认值也是 0，代表不偏移返回的数据点。

示例

返回第 1001 到 1500 的数据点，则 limit 设为 500，offset 设为 1000。

1.    {
2.       "start":1346046400,
3.       "end":1347056500,
4.       "queries":[
5.          {
6.             "aggregator":"avg",
7.             "downsample":"2s-sum",
8.             "metric":"sys.cpu.0",
9.             "limit":"500",
10.             "offset":"1000",
11.             "tags":{
12.                "host":"localhost",
13.                "appName":"hitsdb"
14.             }
15.          }
16.       ]
17.    }

值过滤（dpValue） 说明

根据用户设置的数值限制条件，过滤最终的返回数据点。支持 “>”, “<”, “=”, “<=”, “>=”, “!=”。

1.    {
2.       "start":1346046400,
3.       "end":1347056500,
4.       "queries":[
5.          {
6.             "aggregator":"avg",
7.             "downsample":"2s-sum",
8.             "metric":"sys.cpu.0",
9.             "dpValue":">=500",
10.            "tags":{
11.                "host":"localhost",
12.                "appName":"hitsdb"
13.             }
14.          }
15.       ]
16.    }

差值 (delta) 说明

当用户在子查询中指定差值算子的时候，时序引擎返回的数据的”dps”中的key-value对的value值将是计算所得的差值。需要注意的是，如果未指定差值时返回的”dps”中有 n 个key-value对，那么计算完差值后返回的”dps”中将只包含 n-1 个key-value对（第一个key-value对因无法求差值将被舍去）。差值算子对于Downsample后的值也同样适用。

此外，用户指定了差值算子时，还可以进一步在子查询中指定 “deltaOptions” 来对求差值的行为进行进一步控制。当前支持的 “deltaOptions” 如下所示：

示例

1.    {
2.       "start":1346046400,
3.       "end":1347056500,
4.       "queries":[
5.          {
6.             "aggregator":"none",
7.             "downsample":"5s-avg",
8.             "delta":true,
9.             "deltaOptions":{
10.                 "counter":true,
11.                 "counterMax":100
12.             }
13.             "metric":"sys.cpu.0",
14.             "dpValue":">=50",
15.             "tags":{
16.                "host":"localhost",
17.                "appName":"hitsdb"
18.             }
19.          }
20.       ]
21.    }

降采样 (Downsample) 说明

<interval><units>-<aggregator>[-fill policy]

该查询格式可称作降采样表达式。

其中：

• interval：指数值，如 5、60 等，特殊的“0all”表示时间维度聚合为一个点。
• units：s 代表秒，m 代表分，h 代表小时，d 代表天，n 代表月，y 代表年。
  说明 支持基于日历时间间隔的降采样。要使用日历界限，您需要在时间单位 units 后添加一个c。例如，1dc代表从当日零点到次日零点之间的 24 小时。

• aggregator：降采样使用的算子及其说明如下表所示。

 <interval><units>-<aggregator>-fixed#<number>

聚合（Aggregate）说明

在降采样后会得到多条时间线的值，并且这些时间线的时间戳是对齐的，而聚合就是把多条时间线的值按各个对齐时刻聚合为一条时间线的结果（注意：如果只有一条时间线，则不进行聚合）。聚合时必须要求每条时间线在对应时刻都有值，如果某条时间线在某个时刻没有值，则会进行插值，插值描述如下。

Filters 说明

有以下两种方法可以指定 filter：

• 在指定 tagk 时指定 filter：
  • tagk = *：对 tagk 下面的 tagv 做 groupBy，相同的 tagv 做聚合。
  • tagk = tagv1|tagv2： 分别对 tagk 下面的 tagv1 和 tagv2 数据做聚合。
• 使用 JSON 格式指定 filter：

1.    {
2.        "start": 1356998400,
3.        "end": 1356998460,
4.        "queries": [
5.            {
6.                "aggregator": "sum",
7.                "metric": "sys.cpu.0",
8.                "rate": "true",
9.                "tags": {
10.                    "host": "*",
11.                    "dc": "lga"
12.                }
13.            }
14.        ]
15.    }

1. {
2.  "start": 1356998400,
3.  "end": 1356998460,
4.  "queries": [
5.    {
6.      "aggregator": "sum",
7.      "metric": "sys.cpu.0",
8.      "rate": "true",
9.      "filters": [
10.        {
11.          "type": "wildcard",
12.          "tagk": "host",
13.          "filter": "*",
14.          "groupBy": true
15.        },
16.        {
17.          "type": "literal_or",
18.          "tagk": "dc",
19.          "filter": "lga|lga1|lga2",
20.          "groupBy": false
21.        }
22.      ]
23.    }
24.  ]
25. }

查询结果说明

查询成功的 HTTP 响应码为 200，响应内容为 JSON 格式数据。说明如下：

1.  [
2.    {
3.        "metric": "tsd.hbase.puts",
4.        "tags": {"appName": "hitsdb"},
5.        "aggregateTags": [
6.            "host"
7.        ],
8.        "dps": {
9.            "1365966001": 25595461080,
10.           "1365966061": 25595542522,
11.           "1365966062": 25595543979, 
12.           "1365973801": 25717417859 
13.       } 
14.   }
15.  ]