go操作influxdb 2.x

influxdb是时下热门的时序型数据库
而1.x版本的influxdb和2.x版本是互相不兼容的，代码也是

本文档中使用的包为

import influxdb2 "github.com/influxdata/influxdb-client-go/v2"

注意在操作完成后记得要关闭数据库连接

注册

在完成部署后【部署流程见docker部署InfluxDB】直接用浏览器访问influxdb开放的端口，可以看到start按钮，点击按钮可以直接在页面上进行初始账号的注册

也可以使用代码来进行注册

client := influxdb2.NewClient(url, "")
_, err := client.Setup(context.Background(), user, pwd, org, bucket, timeout)
defer client.Close()

参数	范例值	注释
url	http://127.0.0.1:8086	influxdb的地址，记得要带http://
user		要注册的账号名
pwd		账号的密码，最少8位
org		所属机构，理想用法为InfluxDB存储整个大服务所有的日志，然后用org区分各个微服务/各部门维护的微服务
bucket		给该账户存储用的桶命名
timeout		超时时间，本账号写入的数据在超过此时间之后会自动删除/如果写0则为永久保留

注意这个是用来注册账号的，调一次注册完就可以了
注册完成后我们用注册的账号和密码在influxdb页面上登陆，登进去以后点击左侧菜单的【Data】项，然后点击页面上方的【Tokens】项，最后点击我们刚刚创建的账号的token【我的账号user是root】

点击以后会出现一个弹窗，弹窗上方就是该账号的身份令牌，token

 

我们可以使用这个身份令牌在代码中操作influxdb

写入

写入需要先获取写入对象，获取写入对象需要先创建连接

client := influxdb2.NewClient(url, token)
//获取非阻塞式写入对象
writeAPI := client.WriteAPI(org, bucket)
//获取阻塞式写入对象
writeBlockingAPI := client.WriteAPIBlocking(org, bucket)

参数	范例值	注释
url	http://127.0.0.1:8086	influxdb的地址，记得要带http://
token		就是上文中注册后获取的身份令牌token
org		所属机构，理想用法为InfluxDB存储整个大服务所有的日志，然后用org区分各个微服务/各部门维护的微服务
bucket		指定数据写入该账户下的哪个桶

 

注意写入对象只要根据需要获取一个就好，本文后续以非阻塞式写入对象为例

写入分为两种写法，实际功能没有区别，大家可以选择自己喜欢的风格来使用

行协议风格

client := influxdb2.NewClient(url, token)
writeAPI := client.WriteAPI(org, bucket)

// 使用 line protocol 格式来写入
// 其标准格式如下/注意[]中的内容为选填，可不写/时间如果不写则会自动取插入时间/时间默认为纳秒
// <measurement>[,<tag_key>=<tag_value>[,<tag_key>=<tag_value>]] <field_key>=<field_value>[,<field_key>=<field_value>] [<timestamp>]
// 例子如下
// myMeasurement,tag1=value1,tag2=value2 fieldKey="fieldValue" 1556813561098000000

writeAPI.WriteRecord(fmt.Sprintf("stat,unit=temperature min=%f,max=%f", 23.5, 45.0))
writeAPI.WriteRecord(fmt.Sprintf("stat,unit=temperature min=%f,max=%f", 22.5, 40.0))
writeAPI.Flush()

defer client.Close()

 这种是line protocol风格，这是influx定义的一种写入语法，有兴趣的话可以阅读官方文档系统的学习
大体的语法就是第3行那个样子，注意如果value是字符串的话需要带上双引号
influxdb为了提高写入性能，会有一个类似于mysql的redolog的机制，我们写入的数据不会立刻写入数据库，而是先写入缓存，待合适的时候再写入数据库；writeAPI.Flush()就是让influxdb立刻将缓存的数据写入数据库。
 

point结构体风格

client := influxdb2.NewClient(url, token)
writeAPI := client.WriteAPI(org, bucket)

p := influxdb2.NewPoint("stat",
	map[string]string{"unit": "temperature"},
	map[string]interface{}{"min": 30.0, "max": 35.0},
	time.Now())
writeAPI.WritePoint(p)
writeAPI.Flush()

defer client.Close()

最后是point的链式调用风格，我个人最喜欢这种风格的写法

client := influxdb2.NewClient(url, token)
writeAPI := client.WriteAPI(org, bucket)

p := influxdb2.NewPointWithMeasurement("stat").
	AddTag("unit", "temperature").
	AddField("状态", "正常").
	AddField("max", 35.0)
writeAPI.WritePoint(p)
writeAPI.Flush()

defer client.Close()

查询

因为在influxdb中，每一个Field数据都被视为一个点，所以用代码查询的话，返回的数据是以Field为单位返回的，说实话我觉得有些时候不大方便

client := influxdb2.NewClient(url, token)
defer client.Close()
query := fmt.Sprintf("from(bucket:\"%v\")|> range(start: -3h) |> filter(fn: (r) => r._measurement == \"stat\")", "bucket")

result, err := client.QueryAPI(org).QueryRaw(context.Background(), query, influxdb2.DefaultDialect())
if err != nil {
    log.Fatal(err.Error())
    return
}

result, err := queryAPI.Query(context.Background(), query)
if err != nil {
    panic(err)
}

for result.Next() {
    if result.TableChanged() {
        fmt.Printf("table: %s\n", result.TableMetadata().String())
    }
    fmt.Printf("value: %v\n", result.Record().Value())
}
if result.Err() != nil {
    fmt.Printf("query parsing error: %\n", result.Err().Error())
}

这样就能将刚才写入的数据打出来了

一般情况下我更推荐你直接用浏览器在页面上查看数据
点击左侧菜单栏的Explore，如图所示选择你自己的桶、表，然后点击Submit，就能直接画出图来了

如果你写入的是字符串数据，很显然，字符串是没法在图中量化地表现的，想要查看你写入的字符串数据，需要切换成源数据模式，且需要切换成查询语句写法并删掉生成数据图的那一句

点击【Script Editor】按钮以后会切换到查询语句编辑界面

 如图所示，将 aggregateWindow 整句删除，然后再点击Submit按钮，就可以看到你写入的字符串数据了