前言

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

下载和安装

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

InfluxDB入门教程_数据

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

主要需要修改的内容如下:

meta部分

InfluxDB入门教程_http_02


data部分

InfluxDB入门教程_数据库_03


retention部分

InfluxDB入门教程_http_04


shard-percreation部分

InfluxDB入门教程_数据库_05


monitor部分

InfluxDB入门教程_数据_06


admin部分

InfluxDB入门教程_数据库_07


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

http部分

InfluxDB入门教程_数据库_08


这个端口是用来通过程序来访问的,各种参数的具体含义详见

​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");

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;
}
}

其中Result和Series为QueryResult的内部类,嵌套比较深,取数据比较麻烦,取数据的方法大都类似于

Object obj = queryResult.getResults().get(0).getSeries().get(0).getValues().get(0).get(1);

这种方法

InfluxDBResultMapper

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

InfluxDBResultMapper resultMapper = new InfluxDBResultMapper();
List<NewBean> cpuList = resultMapper.toPOJO(queryResult, NewBean.class);

其中NewBean是一个POJO类

注意事项

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

推荐

InfluxDB入门教程_http_09