Influx Sql系列教程零：安装及influx-cli使用姿势介绍

Posted 2022-08-10 yihuihui

influxdb 时序数据库，因为实际业务中使用到了，然而并没有发现有特别好的文章，完整的介绍influx sql的使用姿势，因此记录下实际开发中学习的体会，主要参考来自于官方文档 Influx Query Language (InfluxQL)

influx已经推出2.0beta版本，并没有使用，后面的所有都是以1.7版本进行说明

I. 安装

安装教程，直接参考官网链接，installing-influxdb-oss，下面只介绍centos/macos两个操作系统的安装姿势

1. centos

通过yum包管理方式实现安装最新的稳定版, 在终端中输入

cat <<EOF | sudo tee /etc/yum.repos.d/influxdb.repo
[influxdb]
name = InfluxDB Repository - RHEL \$releasever
baseurl = https://repos.influxdata.com/rhel/\$releasever/\$basearch/stable
enabled = 1
gpgcheck = 1
gpgkey = https://repos.influxdata.com/influxdb.key
EOF

然后就可以按照常见的yum方式进行安装

sudo yum install influxdb
# 启动
sudo service influxdb start
# 7+ 版本可以使用 systemctl 方式启动
sudo systemctl start influxdb

2. macos

mac推荐通过homebrew方式进行安装，命令也比较简单

brew update
brew install influxdb

3. 相关配置

一般安装完毕之后，如果作为测试的话，直接使用并没有啥问题；但是实际的成产环境中，铁定是需要修改默认配置的

如果需要开启权限校验，访问时需要用户名密码时，可以参考: 190505-InfluxDB之权限管理

如果需要修改数据的存储位置，访问端口号等，可以参考: 190506-InfluxDB之配置修改

II. influx-cli

安装完毕之后，influx自带了一个控制台访问操作的工具: influx，在正式进入后面的influxsql之前，有必要了解一下这个工具如何使用，因为后面的sql，都是需要在它上面玩耍的

官方也给出了它的使用文档，有兴趣的可以参考: InfluxDB command line interface (CLI/shell)

1. 参数

默认情况下，我们直接在控制台输入 influx 之后就可以进入与influxdb交互的终端界面，如果我们修改了influx的默认配置，比如增加了用户名/密码时，这个时候可能需要使用参数来链接到influxdb了

下面给出几个常用的参数

参数	示例	说明
-username	admin	配置访问用户名
-password	admin	配置访问密码
-format	json csv column	格式化输出结果
-host	localhost	influxdb提供访问的域名或ip
-port	8086	influxdb提供访问的端口号
-precisoin	rfc3339(h,m,s,ms,u,ns)	指定time时间戳格式化

一个简单的使用case如下

2. 使用示例

上面的参数是在连接的时候直接指定了，这些参数在连接之后，也是可以再指定的，下面给出以下常用的使用姿势

a. help

直接输入help，会给出一些命令提示

b. auth

因为直接使用前面的方式输入用户名和密码的方式，并不安全，所以推荐的方式是直接influx进去之后，使用auth来权限校验，这种思路和redis-cli的差不多

c. pretty

是输出更加友好的方式，配合-format=json的时候比较合适

注意pretty输入一次表示开启，再输入一次表示关闭

d. precision

时间戳格式化，对人更友好的显示方式

直接输入: precision rfc3339

e. history

influx-cli会保存历史命令（不包括auth），所以可以通过输入这个来查询之前的命令

f. 退出

三种方式

exit/quit/ctrl+d      quits the influx shell

II. 其他

0. 系列博文

• 190509-InfluxDb之时间戳显示为日期格式
• 190506-InfluxDB之配置修改
• 190505-InfluxDB之权限管理
• 180727-时序数据库InfluxDB之备份和恢复策略
• 180726-InfluxDB基本概念小结
• 180725-InfluxDB-v1.6.0安装和简单使用小结

以上内容主要参考自官方文档:

• installing-influxdb-oss
• InfluxDB command line interface (CLI/shell)
• Influx Query Language (InfluxQL)

1. 一灰灰Blog： https://liuyueyi.github.io/hexblog

一灰灰的个人博客，记录所有学习和工作中的博文，欢迎大家前去逛逛

2. 声明

尽信书则不如，已上内容，纯属一家之言，因个人能力有限，难免有疏漏和错误之处，如发现bug或者有更好的建议，欢迎批评指正，不吝感激

• 微博地址: 小灰灰Blog
• QQ： 一灰灰/3302797840

3. 扫描关注

一灰灰blog