InfluxDB入门教程

前言
InfluxDB是一个时序性数据库，详细资料如下
http://liubin.org/blog/2016/02/18/tsdb-intro/

下载和安装
LZ从官网下载的是influxdb-1.2.4_windows_amd64这个版本，这种数据库不需要安装，解压后配置完毕直接使用，解压后的文件为

influx.exe---->influxdb 命令行客户端
influxd.exe---->influxdb服务器
influxdb.conf---->配置文件，指定对应数据存储文件的位置、日志信息、连接数量、连接时间等等功能的具体配置

主要需要修改的内容如下：
meta部分

data部分

retention部分

shard-percreation部分

monitor部分

admin部分

bind-address端口视服务器端口使用情况而定，这个端口是用来通过浏览器访问的
http部分

这个端口是用来通过程序来访问的，各种参数的具体含义详见
https://github.com/mike-zhang/mikeBlogEssays/blob/master/2017/20170206_InfluxDB%E5%AE%89%E8%A3%85%E5%8F%8A%E9%85%8D%E7%BD%AE.md

启动
通过cmd打开window的命令窗口，进入到influxdb的放置目录，执行命令：influxd.exe -config influxdb.conf即可开启influxdb服务，同时按照上面配置文件产生相应的文件

通过http://127.0.0.1:8089即可实现图形化的访问，其中8087是influxdb.conf文件中admin部分bind-address所指定的，在浏览器中输入这个地址即可实现图形化的访问

http请求的方式为http://178.24.1.3:8086，其中178.24.1.3为当前window机器的IP地址，8086为influxdb.conf文件中http部分bind-address所指定的，这种方式是供程序访问的地址；

另外，还可以直接打开influx.exe，通过influxDB提供的命令来查询数据库中的内容；

备份
备份数据库时，按照influxdb.conf文件中meta、data部分指定的meta、data、wal目录，将这三个目录备份即可；

基础概念
InfluxDB教程
https://www.linuxdaxue.com/influxdb-study-series-manual.html

Java持久层框架
官方提供目前只提供了通过http api访问数据库的方式，我们用GitHub上的开源框架与数据库进行交互，项目地址为：https://github.com/influxdata/influxdb-java，主要实现类如下

InfluxDBFactory
是一个工厂类，可以通过如下方式返回一个InfluxDB的实例

InfluxDB influxDB = InfluxDBFactory.connect("http://172.17.0.2:8086", "111", "111");
1
InfluxDBImpl
实现了InfluxDB接口，提供了对数据库操作的基本方法，如新建数据库，删除数据库，插入数据，进行查询

Point
相当于关系型数据库中的一行数据，因为此类数据库一行数据在图中一般显示为一个点，故为Point，可以此类添加行数据，如tag（索引列）field（普通列）

Query
通过要执行的SQL和数据库名构造Query对象，作为参数传递到InfluxDBImpl类的查询方法中，即可返回一个QueryResult对象，里面封装了查询生成的数据

QueryResult
这个类比较复杂

public class QueryResult {
private List<Result> results;
private String error;

public static class Result {
private List<Series> series;
private String error;
}

public static class Series {
private String name;
private Map<String, String> tags;
private List<String> columns;
private List<List<Object>> values;
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
其中Result和Series为QueryResult的内部类，嵌套比较深，取数据比较麻烦,取数据的方法大都类似于

Object obj = queryResult.getResults().get(0).getSeries().get(0).getValues().get(0).get(1);
1
这种方法

InfluxDBResultMapper
可以通过如下方式将查询结构映射到一个Bean中

InfluxDBResultMapper resultMapper = new InfluxDBResultMapper();
List<NewBean> cpuList = resultMapper.toPOJO(queryResult, NewBean.class);
1
2
其中NewBean是一个POJO类

注意事项
通过StringBuilder拼接SQL语句，进行查询，注意不能单独查询tag列，必须有一个field列

心冰之海

InfluxDB入门教程

公告