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，標籤值為server01、在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）：66327412