InfluxDB从原理到实战 - InfluxDB经常使用的基础操做

0x00 基础操做介绍

在本文中将介绍InfluxDB经常使用的基础操做，帮助读者创建对InfluxDB的感性认识，快速的动手玩起来，持续查询（Continuous Queies）、Group by、Series、行协议（Line Protocol）、InfluxQL等高级特性和细节，将会在后续文章中逐步介绍。

InfluxDB支持类SQL的操做接口，尽管由于时序数据的特色，InfluxDB是非CRUD的，不支持更新数据、删除单条数据操做，但考虑到大多数的读者对应CRUD的关系型数据库比较熟悉，在本文中，仍是按照CRUD原则，介绍数据库（Database）、保留策略（Retention Policy）、表（Measurement）、数据写入、数据查询、数据更新、数据删除等内容。

InfluxDB支持influx命令行和InfluxDB API 2种操做接口，在本文中，将以influx命令行的操做为例，介绍上述内容。本文的操做示例，基于InfluxDB最新的稳定版本，InfluxDB-v1.7.8。

0x01 数据库（Database）

1. 建立数据库

经过CREATE语句，建立名为telegraf的数据库。

$ influx
Connected to http://localhost:8086 version 1.7.8
InfluxDB shell version: 1.7.8
> create database telegraf
>复制代码

2. 查看数据库

经过SHOW语句，查看当前全部的数据库。

> show databases;
name: databases
name
----
_internal
monito
telegraf
>复制代码

3. 删除数据库

经过DROP语句，删除名为telegraf的数据库。

> drop database telegraf
>复制代码

4. 使用数据库

经过USE语句，使用名为telegraf的数据库。

> use telegraf
Using database telegraf
>复制代码

0x02 保留策略（Retention Policy）

1. 查看数据库对应的保留策略

经过SHOW语句，查看数据库telegraf对应的保留策略。

> show retention policies on telegraf
name    duration shardGroupDuration replicaN default
----    -------- ------------------ -------- -------
autogen 0s       168h0m0s           1        true
>复制代码

2. 建立保留策略

经过CREATE语句，建立名为rp-one-year的保留策略。

> create retention policy "rp-one-year" on "telegraf" duration 365d replication 1
> 
> show retention policies on telegraf
name        duration  shardGroupDuration replicaN default
----        --------  ------------------ -------- -------
autogen     0s        168h0m0s           1        true
rp-one-year 8760h0m0s 168h0m0s           1        false
> 复制代码

3. 更改保留策略

经过ALTER语句，更改保留策略rp-one-year为数据库telegraf的默认保留策略。

> alter retention policy "rp-one-year" on "telegraf" duration 365d replication 1 default
> 
> show retention policies on telegraf
name        duration  shardGroupDuration replicaN default
----        --------  ------------------ -------- -------
autogen     0s        168h0m0s           1        false
rp-one-year 8760h0m0s 168h0m0s           1        true
>复制代码

4. 删除保留策略

经过DROP语句，删除数据库telegraf的保留策略rp-one-year。

> drop retention policy "rp-one-year" on "telegraf"
> 
> show retention policies on telegraf
name    duration shardGroupDuration replicaN default
----    -------- ------------------ -------- -------
autogen 0s       168h0m0s           1        false
>复制代码

0x03 表（Measurement）

1. 建立表

与MySQL等关系型数据不一样，在InfluxDB中，无需显式建立表，在写入时序数据时，InfluxDB服务器会根据行协议，按需自动建立对应的表。

在数据库telegraf中，插入数据时，自动建立了表devops-idc-sz。

> use telegraf
Using database telegraf
>
> show measurements
> 
> insert devops-idc-sz,host=server01 cpu=23.1,mem=0.63 
> 
> show measurements
name: measurements
name
----
devops-idc-sz
>复制代码

2. 查看measurements

经过SHOW语句，，查看数据库telegraf中的全部的表。

> show measurements
name: measurements
name
----
devops-idc-sz
>复制代码

3. 删除表

经过DROP语句，删除表devops-idc-sz和对应的全部数据。

> drop measurement devops-idc-sz
> 
> show measurements
> 复制代码

0x04 数据写入

经过INSERT语句和行协议，向表devops-idc-sz中插入3条DevOps环境的时序数据记录，时序数据对应的时间为2019/8/30 17:44:53。

> insert devops-idc-sz,host=server01 cpu=16.1,mem=0.43 1567158293000000000
> insert devops-idc-sz,host=server02 cpu=23.8,mem=0.63 1567158293000000000
> insert devops-idc-sz,host=server03 cpu=56.3,mem=0.78 1567158293000000000复制代码

0x05 数据查询

经过SELECT语句，查询表devops-idc-sz中的全部数据。

> select * from devops-idc-sz
name: devops-idc-sz
time                cpu  host     mem
----                ---  ----     ---
1567158293000000000 16.1 server01 0.43
1567158293000000000 56.3 server03 0.78
1567158293000000000 23.8 server02 0.63
>复制代码

0x06 数据更新

由于时序数据多写少读无更新的特色，InfluxDB，不支持数据更新操做，笔者亦不建议对时序数据记录执行更新操做。若是在某些特殊场景下，必须对时序数据记录的指标值进行更新，能够利用“时间戳（Timestamp）和时间序列线（Series）彻底相同的时序数据记录，是同一条时序数据记录，新插入的时序数据，会覆盖原有的时序数据记录”的特性，更新时序数据记录的的指标值。

更新server01在2019/8/30 17:44:53的时序数据记录的指标值。

> insert devops-idc-sz,host=server01 cpu=76.1,mem=0.83 1567158293000000000
> 
> select * from devops-idc-sz
name: devops-idc-sz
time                cpu  host     mem
----                ---  ----     ---
1567158293000000000 76.1 server01 0.83
1567158293000000000 56.3 server03 0.78
1567158293000000000 23.8 server02 0.63
>复制代码

0x07 数据删除

一样，由于时序数据多写少读无更新和批量删除时序数据记录的特色，InfluxDB不支持删除单条时序数据记录。除了经过保留策略周期性的定时删除时序数据记录，InfluxDB还还还支持经过WHERE条件语句、删除时间序列线、删除表、删除数据库、删除分片（Shard）等方式直接批量删除指定的时序数据记录。

1. 经过WHERE条件语句从指定表中删除时序数据记录，从表devops-idc-sz中，删除标签名为host，标签值为server0一、在2019/8/30 17:44:53时间点的时序数据记录。

（注意：WHERE条件语句，不支持指标（Field），只支持标签和时间戳。）

> delete from  devops-idc-sz where "host"='server01' and  time=1567158293s
>复制代码

2. 经过删除时间序列线删除时序数据记录，删除标签对"host"='server01'对应的时间序列线的全部时序数据记录。

> drop series from devops-idc-sz where "host"='server01'
>复制代码

3. 经过删除指定表删除时序数据记录，删除表devops-idc-sz对应的全部时序数据记录。

> drop measurement devops-idc-sz
>复制代码

4. 经过删除指定数据库删除时序数据记录，删除数据库telegraf对应的全部时序数据记录。

> drop database telegraf
>复制代码

5. 经过删除指定分片删除时序数据记录，删除分片 6对应的全部时序数据记录。

> select *  from  devops-idc-sz
name: devops-idc-sz
time                cpu  host     mem
----                ---  ----     ---
1567158293000000000 16.1 server01 0.43
1567158293000000000 56.3 server03 0.78
1567158293000000000 23.8 server02 0.63
> 
> show shards
name: _internal
id database  retention_policy shard_group start_time           end_time             expiry_time          owners
-- --------  ---------------- ----------- ----------           --------             -----------          ------
1  _internal monitor          1           2019-08-27T00:00:00Z 2019-08-28T00:00:00Z 2019-09-04T00:00:00Z 
4  _internal monitor          4           2019-08-30T00:00:00Z 2019-08-31T00:00:00Z 2019-09-07T00:00:00Z 

name: monito
id database retention_policy shard_group start_time           end_time             expiry_time          owners
-- -------- ---------------- ----------- ----------           --------             -----------          ------
3  monitor  autogen          3           2019-04-29T00:00:00Z 2019-05-06T00:00:00Z 2019-05-06T00:00:00Z 
2  monitor  autogen          2           2019-08-26T00:00:00Z 2019-09-02T00:00:00Z 2019-09-02T00:00:00Z 

name: telegraf
id database retention_policy shard_group start_time           end_time             expiry_time          owners
-- -------- ---------------- ----------- ----------           --------             -----------          ------
6  telegraf autogen          6           2019-08-26T00:00:00Z 2019-09-02T00:00:00Z 2019-09-02T00:00:00Z 
> 
> drop shard 6
> 
> select *  from  devops-idc-sz
> 复制代码

后记

欢迎交流讨论:

微信公众号：influxdb-dev

InfluxDB技术交流群（QQ）：663274123