0x00 基礎操作介紹 在本文中將介紹InfluxDB常用的基礎操作，幫助讀者建立對InfluxDB的感性認識，快速的動手玩起來，持續查詢（Continuous Queies）、Group by、Series、行協議（Line Protocol）、InfluxQL等高級特性和細節，將會在後續文章中逐 ...
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）：663274123。
