简介

       InfluxDB 是一个开源分布式时序、事件和指标数据库。使用Go语言编写,无需外部依赖。其设计目标是实现分布式和水平伸缩扩展。

       它有三大特性:

       1. Time Series (时间序列):你可以使用与时间有关的相关函数(如最大,最小,求和等);

       2. Metrics(度量):你可以实时对大量数据进行计算;

       3. Eevents(事件):它支持任意的事件数据。

       详细请参考官网:https://influxdata.com/

安装

       采用的是influxdb-0.13.0-static_linux_amd64.tar.gz,直接解压缩,进入解压目录运行

./influxd -pidfile influxd.pid -config influxdb.conf

其它安装方式请参考:

https://docs.influxdata.com/influxdb/v0.13/introduction/installation/

下载地址:https://dl.influxdata.com,找到对应版本的Key,拼上前面的url即可下载。

       注意influxdb.conf需要按照修改某些dir和port。influxdb服务默认使用端口:

TCP port 8083 is used for InfluxDB’s Admin panel
TCP port 8086 is used for client-server communication over InfluxDB’s HTTP API

       8088端口其实也被占用了,而且不可配置,参见https://github.com/influxdata/influxdb/blob/master/cmd/influxd/run/config.go第36行DefaultBindAddress。之前的influxdb版本TCP ports 8088是可配置的。

使用

       可采用influx命令或者在浏览器中输入localhost:8083 即可进入web管理页面来使用。

       1.  创建数据库:  CREATE DATABASE testDB

       2.  显示所有数据库: show databases

       3.  删除数据库: DROP DATABASE "db_name"

       4.  使用数据库: use testDB

       5.  显示该数据库中的表 : SHOW MEASUREMENTS

       6.  删除表:  DROP MEASUREMENT "measurementName"

       7.  增:

            命令行:

use testDB
          insert weather,altitude=1000,area=北 temperature=11,humidity=-4

            Http接口:

curl -i -XPOST 'http://localhost:8086/write?db=testDB' 
                          --data-binary 'weather,altitude=1000,area=北 temperature=11,humidity=-4'

            插入数据的格式似乎比较奇怪,这是因为influxDB储存数据所采用的是Line Protocol格式。在上面两个插入数据的方法中,都有一样的部分。

weather,altitude=1000,area=北 temperature=11,humidity=-4

            其中:

            weather : 表名

            altitude=1000,area=北 : tag

            temperature=11,humidity=-4 :field

       8

. 删与改:在InfluxDB中并没有提供数据的删除与修改方法。可以通过数据保存策略(Retention Policies)来实现删除。

       9

. 查:

            命令行:

use testDB
          # 查询最新的三条数据
          SELECT * FROM weather ORDER BY time DESC LIMIT 3

            Http接口

curl -G 'http://localhost:8086/query?pretty=true' 
                  --data-urlencode "db=testDB" 
                  --data-urlencode "q=SELECT * FROM weather ORDER BY time DESC LIMIT 3"

            InfluxDB是支持类SQL语句的,具体的查询语法都差不多。

       10. 用户管理:(以下语句都可以直接在InfluxDB的Web管理界面中调用)

              显示用户   SHOW USERS

              创建用户   CREATE USER "username" WITH PASSWORD 'password'

              创建管理员权限的用户   CREATE USER "username" WITH PASSWORD 'password' WITH ALL PRIVILEGES

              删除用户   DROP USER "username"

几个关键概念

       measurement,就相当于关系数据库中的table,就是tag,field,time的容器;

       对于influxDb的measurement来说,field是必须的,并且不能根据field来排序;

       Tag是可选的,tag可以用来做索引,tag是以字符串的形式存放的;tag字段一般用于where中限制条件。

       retention policy,保留策略,用于决定要保留多久的数据,保存几个备份,以及集群的策略等;

       series,a series is the collection of data that share a retention policy, measurement, and tag set。

Java操作

创建client

private static InfluxDB getClient() {
    InfluxDB client = InfluxDBFactory.connect("http://10.210.228.89:9501", "root", "123456");
    Pong pong = client.ping();
    if (pong != null) {
        System.out.println("Pong : " + pong);
    } else
        return null;
    client.createDatabase(dbName);
    return client;
}

写数据:

private static void writeData001() {
    Point point001 = Point.measurement("cpu")
            .time(System.currentTimeMillis(), TimeUnit.MILLISECONDS)
            .tag("ip", "127.0.0.1").tag("hostname", "localhost")
            .addField("idle", 80L)
            .addField("user", 9L)
            .addField("system", 11L)
            .build();
    Point point002 = Point.measurement("disk")
            .time(System.currentTimeMillis(), TimeUnit.MILLISECONDS)
            .tag("ip", "127.0.0.1")
            .addField("used", 80L)
            .addField("free", 1L)
            .build();

    BatchPoints batchPoints = BatchPoints
            .database(dbName)
            //.tag("async", "true") //Add a tag to this set of points.
            .retentionPolicy("default")
            .consistency(InfluxDB.ConsistencyLevel.ALL)
            .build();
    batchPoints.point(point001).point(point002);
    client.write(batchPoints);
}

private static void writeData002() {
    // Flush every 2000 Points, at least every 100ms
    client.enableBatch(2000, 100, TimeUnit.MILLISECONDS);

    Point point1 = Point.measurement("cpu")
            .time(System.currentTimeMillis(), TimeUnit.MILLISECONDS)
            .addField("idle", 90L)
            .addField("user", 9L)
            .addField("system", 1L)
            .build();
    Point point2 = Point.measurement("disk")
            .time(System.currentTimeMillis(), TimeUnit.MILLISECONDS)
            .addField("used", 80L)
            .addField("free", 1L)
            .build();

    client.write(dbName, "default", point1);
    client.write(dbName, "default", point2);
}

查询:

1. private static void
2. new Query("SELECT idle FROM cpu", dbName);  
3.     QueryResult queryResult = client.query(query);  
4.     System.out.println(queryResult);  
5. }