全部产品
云市场

使用Influx CLI(命令行界面)连接TSDB For InfluxDB®

更新时间:2019-05-18 11:13:09

通过Influx CLI,用户可以方便地连接到TSDB For InfluxDB®,进行数据读写。本文主要介绍如何使用Influx CLI连接到阿里云上的TSDB For InfluxDB®,并且如何通过CLI写入数据和查询数据。

准备工作

首先,需要在阿里云官网上购买TSDB For InfluxDB®实例,并成功创建用户账号。Influx CLI连接TSDB For InfluxDB®需要用到用户账号和密码。

下载CLI

进入到下载页面,选择InfluxDB v1.7.6,如下图所示。

然后根据操作系统的不同,下载合适的二进制包,如下图所示。

解压下载好的二进制包,进入到解压后的文件夹,在目录usr/bin/下可获得命令行工具:influx(如果下载的是Windows二进制包,只需进入到解压后的文件夹即可获得二进制文件influx.exe)。例如,如果用户使用的是Mac OS X操作系统,可按如下方式下载和进入influx所在的目录:

  1. $ wget https://dl.influxdata.com/influxdb/releases/influxdb-1.7.6_darwin_amd64.tar.gz
  2. $ tar zxvf influxdb-1.7.6_darwin_amd64.tar.gz
  3. $ cd influxdb-1.7.6-1/usr/bin
  4. $

通过CLI连接TSDB For InfluxDB®

打开终端,输入如下命令即可连接到您所购买的实例:

  1. $ ./influx -ssl -username <账号名称> -password <密码> -host <网络地址> -port 3242

TSDB For InfluxDB®使用SSL协议保障数据传输过程中的安全性。”-ssl”,”-username”,”-password”,”-host”和”-port”这五个参数是必需的,在每次连接TSDB For InfluxDB®的时候都需要提供。

参数解释

  • -ssl:指的是使用HTTPS连接InfluxDB服务器

  • -username:指的是已创建好的用户账号

  • -password:指的是用户账号对应的密码

  • -host:指的是网络地址,在管理控制台的实例详情中可查看,如下图所示。

  • -port: 指的是网络端口,默认是3242

通过CLI写入数据

在写入数据前,需要先创建数据库,假设已成功创建名为”mydb”的数据库。

单点写入

1.通过Influx CLI连接TSDB For InfluxDB®。

  1. $ ./influx -ssl -username <账号名称> -password <密码> -host <网络地址> -port 3242

2.指定使用数据库”mydb”。

  1. > USE mydb
  2. Using database mydb

3.将单个数据点写入数据库”mydb”。

  1. > INSERT cpu,host=serverA,region=us_west value=0.64

这条语句将一个数据点写入数据库”mydb”的默认保留策略中。其中,cpu是measurement,hostregion是tag,value是field,数据点的格式符合行协议。如果没有提供时间戳,系统会把服务器本地的纳秒级的Unix时间当作数据点的时间戳。在TSDB For InfluxDB®中,任何时间戳都是UTC时间(协调世界时)。

文件导入

1.示例数据:文件test.txt,里面包含多个数据点。

  1. # DML
  2. # CONTEXT-DATABASE: mydb
  3. # CONTEXT-RETENTION-POLICY: autogen
  4. h2o_feet,location=coyote_creek water_level=3.524,level\ description="between 3 and 6 feet" 1439868600
  5. h2o_feet,location=coyote_creek water_level=3.399,level\ description="between 3 and 6 feet" 1439868960
  6. h2o_feet,location=coyote_creek water_level=3.278,level\ description="between 3 and 6 feet" 1439869320
  7. h2o_feet,location=coyote_creek water_level=3.159,level\ description="between 3 and 6 feet" 1439869680
  8. h2o_feet,location=coyote_creek water_level=3.048,level\ description="between 3 and 6 feet" 1439870040
  9. h2o_feet,location=coyote_creek water_level=2.943,level\ description="below 3 feet" 1439870400
  10. h2o_feet,location=coyote_creek water_level=2.831,level\ description="below 3 feet" 1439870760
  11. h2o_feet,location=coyote_creek water_level=2.717,level\ description="below 3 feet" 1439871120
  12. h2o_feet,location=coyote_creek water_level=2.625,level\ description="below 3 feet" 1439871480
  13. h2o_feet,location=coyote_creek water_level=2.533,level\ description="below 3 feet" 1439871840

2.将文件中的数据导入TSDB For InfluxDB®。

  1. $ ./influx -ssl -username <账号名称> -password <密码> -host <网络地址> -port 3242 -import -path=test.txt

使用参数-import可将文件中的数据导入TSDB For InfluxDB®,其中,-path指定需要被导入的文件。这条语句将measurement为”h2o_feet”,tag为”location”,field为”water_level”和”level description”的数据写入数据库”mydb”中。

通过CLI查询数据

TSDB For InfluxDB®支持丰富的InfluxQL查询语句,InfluxQL是一种类似SQL的语言,能够让用户方便快捷地与数据进行交互,详情可看官方文档数据探索Schema探索

在进行数据查询前,需要先连接TSDB For InfluxDB®:

  1. $ ./influx -ssl -username <账号名称> -password <密码> -host <网络地址> -port 3242

然后,指定从哪个数据库中查询数据,在本文的示例中,数据来自数据库”mydb”:

  1. > USE mydb
  2. Using database mydb

查询指定measurement中的所有数据

  1. > SELECT * FROM "h2o_feet"
  2. name: h2o_feet
  3. time level description location water_level
  4. ---- ----------------- -------- -----------
  5. 1439868600 between 3 and 6 feet coyote_creek 3.524
  6. 1439868960 between 3 and 6 feet coyote_creek 3.399
  7. 1439869320 between 3 and 6 feet coyote_creek 3.278
  8. 1439869680 between 3 and 6 feet coyote_creek 3.159
  9. 1439870040 between 3 and 6 feet coyote_creek 3.048
  10. 1439870400 below 3 feet coyote_creek 2.943
  11. 1439870760 below 3 feet coyote_creek 2.831
  12. 1439871120 below 3 feet coyote_creek 2.717
  13. 1439871480 below 3 feet coyote_creek 2.625
  14. 1439871840 below 3 feet coyote_creek 2.533

该查询返回名为”h2o_feet”的measurement对应的所有数据。

查询measurement中特定的field并进行算术运算

  1. > SELECT ("water_level" + 2) * 3 FROM "h2o_feet"
  2. name: h2o_feet
  3. time water_level
  4. ---- -----------
  5. 1439868600 16.572
  6. 1439868960 16.197
  7. 1439869320 15.834000000000001
  8. 1439869680 15.477
  9. 1439870040 15.144
  10. 1439870400 14.828999999999999
  11. 1439870760 14.492999999999999
  12. 1439871120 14.151000000000002
  13. 1439871480 13.875
  14. 1439871840 13.598999999999998

“water_level”是”h2o_feet”中的一个field,该查询将”water_level”中的每个值加2,然后乘以3。请注意,TSDB For InfluxDB®遵循标准的算术运算顺序,可查看数学运算符了解更多相关信息。

查询field value满足一定条件的数据

  1. > SELECT * FROM "h2o_feet" WHERE "water_level" > 3
  2. name: h2o_feet
  3. time level description location water_level
  4. ---- ----------------- -------- -----------
  5. 1439868600 between 3 and 6 feet coyote_creek 3.524
  6. 1439868960 between 3 and 6 feet coyote_creek 3.399
  7. 1439869320 between 3 and 6 feet coyote_creek 3.278
  8. 1439869680 between 3 and 6 feet coyote_creek 3.159
  9. 1439870040 between 3 and 6 feet coyote_creek 3.048

该查询返回中”h2o_feet”中的数据,这些数据满足条件:”water_level”的值大于3。更多关于WHERE子句的介绍可查看官方文档

将查询结果分组

  1. > SELECT MEAN("water_level") FROM "h2o_feet" GROUP BY "location"
  2. name: h2o_feet
  3. tags: location=coyote_creek
  4. time mean
  5. ---- ----
  6. 0 3.0057

该查询将查询结果按”location”分组,并计算每个”location”中的”water_level”的平均值。更多关于GROUP BY子句的介绍可查看官方文档

使用正则表达式指定field key和tag key

  1. > SELECT /level/ FROM "h2o_feet"
  2. name: h2o_feet
  3. time level description water_level
  4. ---- ----------------- -----------
  5. 1439868600 between 3 and 6 feet 3.524
  6. 1439868960 between 3 and 6 feet 3.399
  7. 1439869320 between 3 and 6 feet 3.278
  8. 1439869680 between 3 and 6 feet 3.159
  9. 1439870040 between 3 and 6 feet 3.048
  10. 1439870400 below 3 feet 2.943
  11. 1439870760 below 3 feet 2.831
  12. 1439871120 below 3 feet 2.717
  13. 1439871480 below 3 feet 2.625
  14. 1439871840 below 3 feet 2.533

该查询返回所有包含字符串”level”的field key和tag key对应的数值。更多关于正则表达式的介绍可查看官方文档


InfluxDB® is a trademark registered by InfluxData, which is not affiliated with, and does not endorse, TSDB for InfluxDB®.