InfluxDB学习之InfluxDB的HTTP API查询操作

时间:2023-12-27 19:38:31

在 InfluxDB学习 的上一篇文章:InfluxDB学习之InfluxDB的HTTP API写入操作 中,我们介绍了使用InfluxDB的HTTP API进行数据写入操作的过程,本文我们再来介绍下使用InfluxDB的HTTP API进行数据查询操作的过程。更多InfluxDB详细教程请看:InfluxDB系列学习教程目录

InfluxDB技术交流群:580487672(点击加入)

InfluxDB学习之InfluxDB的HTTP API查询操作

一、说明

官方文档上介绍说,使用HTTP API进行查询是比较初级的一种方式。推荐使用第三方语言库和客户端管理程序进行查询操作。

二、InfluxDB进行HTTP API查询方法

使用HTTP API在InfluxDB进行查询主要是发送 GET 请求到 InfluxDB的 /query 端,调用示例如下所示:

curl -GET 'http://localhost:8086/query?pretty=true' --data-urlencode "db=mydb"
--data-urlencode "q=SELECT value FROM cpu_load_short WHERE region='us-west'"

参数db指定了需查询的数据库,q代表了需执行的查询语句。

在页面中也提供了生成HTTP 请求URL的方法,如下所示:

InfluxDB学习之InfluxDB的HTTP API查询操作

在界面上输入语句后,点击生成url就会生成http请求URL。

在浏览器执行后,会返回json格式的串。

如果查询出错的话,则会返回关键词“error”+错误信息。

三、InfluxDB进行HTTP API查询多条数据

我们可能需要用InfluxDB进行多条查询,HTTP API提供的多条查询的格式如下所示:

curl -G 'http://localhost:8086/query?pretty=true' --data-urlencode "db=mydb" --data-urlencode "q=SELECT value FROM cpu_load_short WHERE region='us-west';
SELECT count(value) FROM cpu_load_short WHERE region='us-west'"

格式与单条查询相同,只是在多条语句之间要用分号“;”分隔。

返回值也是包含结果的json串。

四、InfluxDB HTTP 查询的格式化输出

1)规定时间格式

在使用HTTP查询时可以使用 epoch 参数指定输出的时间格式。可选值有 epoch=[h,m,s,ms,u,ns]。

例如:

curl -G 'http://localhost:8086/query' --data-urlencode "db=mydb"
--data-urlencode "epoch=s" --data-urlencode "q=SELECT value FROM cpu_load_short WHERE region='us-west'"

这样会获取到以秒为单位的时间数据。

2)指定每次查询数据大小

可以使用 chunk_size 参数来指定每次结果的大小。比如,我要结果每次返回200个点的数据,则如下所示:

curl -G 'http://localhost:8086/query' --data-urlencode "db=mydb" --data-urlencode "chunk_size=200" --data-urlencode "q=SELECT value FROM cpu_load_short WHERE region='us-west'"

这样查询结果就会返回200个点的数据。

好了,有关 InfluxDB 有关HTTP API操作的相关知识就先为大家介绍到这里,更多有关InfluxDB的内容请看 Linux大学接下来的文章。

更多InfluxDB详细教程请看:InfluxDB系列学习教程目录

InfluxDB技术交流群:580487672(点击加入)