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