01.安装及influx-cli使用姿势介绍
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