01-influxdb2时序数据库简介及安装

# 一、Influxdb2简介

InfluxDB 是一个由 InfluxData 开发的开源时序型数据。它由 Go 写成，着力于高性能地查询与存储时序型数据。InfluxDB 被广泛应用于存储系统的监控数据，IoT 行业的实时数据等场景

InfluxDB 其在 DB-engines 上的时序数据库排行榜稳居第一；InfluxData 对于物联网的数据采集、存储、分析、可视化等提供了一整套开源组件，简称为 TICK(Telegraf、 InfluxDB、Chronograf、Kapacitor)，系统的整体结构如下图所示：

2021年6月份，发布 influxdb2.x，与前面版本有结构性差异

优点：

1、类似 NoSQL 在插入数据时，无需先创建数据存储结构，它的存储结构可以根据数据自动推断出来。
2、可以支持使用类 SQL 命令执行操作（V1.x 版本），但学习 Flux 的脚本语言更有利于操作数据流。
3、低成本存储，采样时序数据，压缩存储。
4、丰富的聚合函数，支持AVG、SUM、MAX、MIN等聚合函数。
5、高性能读、高性能写、高存储率。
6、相比较其他时序数据库，社区相对活跃。

缺点：

1、集群版本不开源，需要自己改造源码实现集群，一旦版本更新可能对自己实现的部分有影响，需要跟着修改；当然 github 上面也有开源的集群版。

2、对于 InfluxDB 2.x 由于是新出的，相关资料比较少，网上关于 InfluxDB 的文章大部分都是 1.x 版本，目前只能参考官网的英文文档。

3、2.x 版本使用 Flux 语法替代了 InfluxQL（类SQL）查询，需要花时间学习语法

Influxdb是由Golang 构建的时序数据库，由于由Go语言构建使得其跨平台部署相对方便。用户只需下载其可执行文件到相应系统执行即可。

# 二、数据库的安装

方法一： 直接使用 编译好的包
os系统： linux ---Ubuntu、centos
rpm：

```shell
wget https://dl.influxdata.com/influxdb/releases/influxdb2-2.2.0.x86_64.rpm 
yum install influxdb2-2.2.0.x86_64.rpm -y
```

启动数据库：

```shell
systemctl start influxdb 
service influxdb start 
influxdb run
```

方式二： docker方式来安装

os： centos + docker

以默认配置文件安装：

```shell
docker run -itd --name influxdb2 -p 8086:8086 influxdb:2.4.0
```

```
docker run -itd -p 8086:8086 --name influxdb2 \
      -v /tqls_system/influxdb2/data:/var/lib/influxdb2 \
      -v /tqls_sytem/influxdb2/config/:/etc/influxdb2 \
      -e DOCKER_INFLUXDB_INIT_MODE=setup \
      -e DOCKER_INFLUXDB_INIT_USERNAME=admin \
      -e DOCKER_INFLUXDB_INIT_PASSWORD=Linux@123.0# \
      -e DOCKER_INFLUXDB_INIT_ORG=study \
      -e DOCKER_INFLUXDB_INIT_BUCKET=study-bucket \
      influxdb:2.2
```

`-e DOCKER_INFLUXDB_INIT_MODE=setup` 指其定为初始化模式。

`-e DOCKER_INFLUXDB_INIT_USERNAME=admin `指定用户名

`-e DOCKER_INFLUXDB_INIT_PASSWORD=Linux@123.0# `指定密码

`-e DOCKER_INFLUXDB_INIT_ORG=study `创建初始org

`-e DOCKER_INFLUXDB_INIT_BUCKET=study-bucket `创建初始bucket

自定义配置文件安装：

```shell
#获取配置文件
docker run \
  --rm influxdb:2.4.0 \
  influxd print-config > config.yml
  
#编辑配置文件 cat config.yml
assets-path: ""
bolt-path: /var/lib/influxdb2/influxd.bolt
e2e-testing: false
engine-path: /var/lib/influxdb2/engine
feature-flags: {}
flux-log-enabled: false
hardening-enabled: false
http-bind-address: :8086
http-idle-timeout: 3m0s
http-read-header-timeout: 10s
http-read-timeout: 0s
http-write-timeout: 0s
influxql-max-select-buckets: 0
influxql-max-select-point: 0
influxql-max-select-series: 0
instance-id: ""
key-name: ""
log-level: info
metrics-disabled: false
nats-max-payload-bytes: 0
nats-port: 4222
no-tasks: false
pprof-disabled: false
query-concurrency: 1024
query-initial-memory-bytes: 0
query-max-memory-bytes: 0
query-memory-bytes: 0
query-queue-size: 1024
reporting-disabled: false
secret-store: bolt
session-length: 60
session-renew-disabled: false
sqlite-path: ""
storage-cache-max-memory-size: 1073741824
storage-cache-snapshot-memory-size: 26214400
storage-cache-snapshot-write-cold-duration: 10m0s
storage-compact-full-write-cold-duration: 4h0m0s
storage-compact-throughput-burst: 50331648
storage-max-concurrent-compactions: 0
storage-max-index-log-file-size: 1048576
storage-no-validate-field-size: false
storage-retention-check-interval: 30m0s
storage-series-file-max-concurrent-snapshot-compactions: 0
storage-series-id-set-cache-size: 0
storage-shard-precreator-advance-period: 30m0s
storage-shard-precreator-check-interval: 10m0s
storage-tsm-use-madv-willneed: false
storage-validate-keys: false
storage-wal-fsync-delay: 0s
storage-wal-max-concurrent-writes: 0
storage-wal-max-write-delay: 10m0s
storage-write-timeout: 10s
store: disk
testing-always-allow-setup: false
tls-cert: ""
tls-key: ""
tls-min-version: "1.2"
tls-strict-ciphers: false
tracing-type: ""
ui-disabled: false
vault-addr: ""
vault-cacert: ""
vault-capath: ""
vault-client-cert: ""
vault-client-key: ""
vault-client-timeout: 0s
vault-max-retries: 0
vault-skip-verify: false
vault-tls-server-name: ""
vault-token: ""

#安装
docker run -p 8086:8086 \
  -v $PWD/config.yml:/etc/influxdb2/config.yml \
  influxdb:2.4.0
```

访问地址： http://influxdb_ip:8086

# 三、数据库的使用

官方文档：https://docs.influxdata.com/influxdb/v2.4/security/tokens/create-token/#manage-tokens-in-the-influxdb-ui

admin

Linux@123.0#

## influxDB UI创建令牌

ui界面中，点击 get start

记住： org、bucket名称

点击 **用户头像> about 看到 orgid、 userid**

点击 **data > APITokens**，查看或者创建令牌

![A1](https://tqls-mrdoc.oss-cn-beijing.aliyuncs.com/mr-doc/A1.png)

```
s9-YTkaURbSb8xUeJ3QbXtZLzkcTD2LPcA0OYLKBC0dlhM_yMduRHTk_bry6lLoEtcg4Nz88G9LOkBaQ_zZhPA==
```

点击 **data > Buckets** 可以看到bucket的id

```
972df276a4efe8b9
```

![A2](https://tqls-mrdoc.oss-cn-beijing.aliyuncs.com/mr-doc/A2.png)

## influxDB 命令创建令牌

使用influx auth create命令创建令牌。在命令中包含标志以授予令牌特定权限。查看可用的标志。只有拥有write: authorizations权限的令牌才能创建令牌。

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

#### 创建一个 All-Access 令牌

创建一个 All-Access 令牌以授予对组织中所有资源的权限。

```sh
influx auth create \
  --org my-org \
  --all-access
```

#### 创建操作员令牌

创建一个 Operator 令牌以授予对所有组织中的所有资源的权限。

```sh
influx auth create \
  --org my-org \
  --operator
```

#### 创建具有指定读取权限的令牌

```sh
influx auth create \
  --org my-org \
  --read-bucket 03a2bbf46309a000 \
  --read-bucket 3a87c03ace269000 \
  --read-dashboards \
  --read-tasks \
  --read-telegrafs \
  --read-user
```

还可以使用influx API创建令牌，请参考官方文档