influxDB 2.0安装及使用说明

目前influxdb2.0还处于beta阶段，网上的相关资料较少，根据自己的使用过程，特别整理此说明文档。

更多内容分享，欢迎关注公众号：Go开发笔记

一、安装
我们根据官方文档开始：https://v2.docs.influxdata.com/v2.0/get-started/

1.下载

打开官方文档选则平台，我这里是mac，点击下载即可。

2.解压
3.设置环境变量（可选）
sudo cp influxdb_2.0.0-beta.5_darwin_amd64/{influx,influxd} /usr/local/bin/

如果之前设置了1.x的路径，由于2.0的可执行文件与1.x一致，此时可以通过替换或重命名文件实现。

Both InfluxDB 1.x and 2.x include influx and influxd binaries. If InfluxDB 1.x binaries are already in your $PATH, run the 2.0 binaries in place or rename them before putting them in your $PATH. If you rename the binaries, all references to influx and influxd in this documentation refer to your renamed binaries.

二、启动
1.启动命令
influxd
1
注意：macOS Catalina的版本可能需要处理安全问题，运行命令后，系统偏好设置-安全性与隐私-（左下角）允许运行

2.初次使用设置
有以下几种方式：

(1)使用UI界面设置
访问http://localhost:9999

点击Get Started

按要求输入Username、Password、Confirm Password、Organization Name、Bucket Name

点击Continue

(2)使用CLI命令设置
influx setup

按要求依次输入primary username、password、Confirm Password、Organization Name、Bucket Name、retention period

（3）使用CLI命令快速设置
此方法在github的readme中提到。

influx setup --username marty --password F1uxKapacit0r85 --org InfluxData --bucket telegraf --retention 168 --token where-were-going-we-dont-need-roads --force

3.默认启动端口
influxDB 2.0测试版默认使用9999端口，注意：正式版仍使用8086端口。通过此端口，我们可以使用其http接口服务。influxDB 1.x默认使用8086端口。

三、使用
官网教程并不完善，需要结合其github项目的readme来使用。

1.influx部分语法说明
特别注意：influxDB 2.0版本相对1.x版本改动较大，尤其是语法方面的改动，2.0版本的语法使用的是JavaScript，1.x使用的是sql。

Flux design principles
Flux is designed to be usable, readable, flexible, composable, testable, contributable, and shareable.
Its syntax is largely inspired by 2018’s most popular scripting language, Javascript, and takes a functional approach to data exploration and processing.

示例如下：

from(bucket:"example-bucket")
  |> range(start:-1h)
  |> filter(fn:(r) =>
    r._measurement == "cpu" and
    r.cpu == "cpu-total"
  )
  |> aggregateWindow(every: 1m, fn: mean)

（1）from 指定数据源bucket
from(bucket:“example-bucket”)

(2) |> 管道连接符
将数据从数据源管道传输到指定地方，如range()

(3)range 指定起始时间段
range有两个参数start，stop，stop不设置默认为当前。range可以是相对的（使用负持续时间）或绝对（使用时间段）。

// Relative time range with start only. Stop defaults to now.
from(bucket:"example-bucket")
  |> range(start: -1h)

// Relative time range with start and stop
from(bucket:"example-bucket")
  |> range(start: -1h, stop: -10m)
  
// Absolute time range with start and stop
from(bucket:"example-bucket")
  |> range(start: 2020-03-02T01:00:00Z)

(4）filter 过滤
对range()中的数据进行过滤，filter()有一个参数fn，是基于列和属性过滤数据逻辑的匿名函数。
flux的匿名函数语法与JavaScript的语法类似。记录或行在filter()中作为对象®。多个过滤规则间用and连接。
语法如下：

// Pattern
(r) => (r.objectProperty comparisonOperator comparisonExpression)

示例如下：

// Example with single filter
(r) => (r._measurement == "cpu")

// Example with multiple filters
(r) => (r._measurement == "cpu") and (r._field != "usage_system" )
（5）基于以上常用语法示例
一个完整的查询示例如下：

from(bucket:"example-bucket")
  |> range(start: -15m)
  |> filter(fn: (r) =>
    r._measurement == "cpu" and
    r._field == "usage_system" and
    r.cpu == "cpu-total"
  )

表示：查询example-bucket最近15分钟cpu相关数据。

（6）yield
flux的yield()函数作为查询结果输出过滤的tables。

from(bucket:"example-bucket")
  |> range(start: -15m)
  |> filter(fn: (r) =>
    r._measurement == "cpu" and
    r._field == "usage_system" and
    r.cpu == "cpu-total"
  )
  |> yield()

为了输出和可视化数据，Flux在每个脚本的末尾自动添加一个yield()函数。只有在同一个流量查询中包含多个查询时，才需要显式调用yield()。每一组返回的数据都需要使用yield()函数来命名。

2.influx命令
1.authentication token
InfluxDB使用authentication tokens来确保用户和数据间的安全交互。

（1）生成token

在UI界面设置：

登录UI界面后，点击侧边栏Load Data
点击Tokens，点击Generate，选择token类型
添加描述，点击Save即可
CLI命令设置：

# Syntax
influx auth create -o <org-name> [permission-flags]

# Example
influx auth create -o my-org </br>
  --read-buckets 03a2bbf46309a000 03ace3a87c269000 \
  --read-dashboards \
  --read-tasks \
  --read-telegrafs \
  --read-user
（2）查看token

可以在http://localhost:9999/orgs/{org_id}/load-data/tokens界面查看，如下：

点击root’s token即可看到token。

将token保存至文件 ~/.influxdbv2/credentials中，后续influx的命令默认读取此token。

当然，也可以通过cli设置token。

2.命令
1.查找organization ID and bucket ID

（1）查找organization ID

influx org find

（2）查找bucket ID
项目readme中为

influx bucket find 此命令其实会报错Error: Must specify org-id, or org name.

查看help：

influx bucket find -h

实际查询bucket id的命令为：

influx bucket find -o org_name

3.write

（1）使用命令

influx write --org InfluxData --bucket telegraf --precision s “m v=2 $(date +%s)”

（2)使用http接口

curl --header “Authorization: Token $(cat ~/.influxdbv2/credentials)” --data-raw “m v=2 $(date +%s)” “http://localhost:9999/api/v2/write?org=InfluxData&bucket=telegraf&precision=s”

（3）使用influxDB的client

根据语言选择对应版本的client

4.read

influx query -o InfluxData ‘from(bucket:“telegraf”) |> range(start:-1h)’

5.使用REPL
连接后不用反复使用influx的命令

（1）连接
influx repl -o InfluxData

（2）read

from(bucket:“telegraf”) |> range(start:-1h)

实际上官网的教程也是从使用REPL开始的，如果没有连接，后续的所有使用都无法进行。