InfluxDB的HTTP API寫入操作

一、說明

為了方便，本文主要使用curl來發起http請求，示例當中也是使用curl這個工具來模擬HTTP 請求。

在實際使用中，可以將請求寫入代碼中，通過其他編程語言來模擬HTTP請求。

二、InfluxDB通過HTTP API操作數據庫

1）建立數據庫

curl -POST http://localhost:8086/query --data-urlencode "q=CREATE DATABASE mydb"

執行這個語句后，會在本地建立一個名為mydb的數據庫。

2）刪除數據庫

curl -POST http://localhost:8086/query --data-urlencode "q=DROP DATABASE mydb"

其實使用HTTP API就是向 InfluxDB 接口發送相應的POST請求。

將語句通過POST方式發送到服務器。

三、InfluxDB通過HTTP API添加數據

InfluxDB通過HTTP API添加數據主要使用如下格式：

curl -i -XPOST 'http://localhost:8086/write?db=mydb' --data-binary 'cpu_load_short,host=server01,region=us-west value=0.64 1434055562000000000'

說明：db=mydb是指使用mydb這個數據庫。

--data-binary后面是需插入數據。

cpu_load_short是表名（measurement），tag字段是host和region，值分別為：server01和us-west。

field key字段是value，值為0.64。

時間戳（timestamp）指定為1434055562000000000。

這樣，就向mydb數據庫的cpu_load_short表中插入了一條數據。

其中，db參數必須指定一個數據庫中已經存在的數據庫名，數據體的格式遵從InfluxDB規定格式，首先是表名，后面是tags，然后是field，最后是時間戳。tags、field和時間戳三者之間以空格相分隔。

四、InfluxDB通過HTTP API添加多條數據

InfluxDB通過HTTP API添加多條數據與添加單條數據相似，示例如下：

curl -i -XPOST 'http://localhost:8086/write?db=mydb' --data-binary 'cpu_load_short,host=server02 value=0.67
cpu_load_short,host=server02,region=us-west value=0.55 1422568543702900257
cpu_load_short,direction=in,host=server01,region=us-west value=2.0 1422568543702900257'

?

這條語句向數據庫mydb的表cpu_load_short中插入了三條數據。

第一條指定tag為host，值為server02，第二條指定tag為host和region，值分別為server02和us-west，第三條指定tag為direction，host，region，值分別為：in，server01，us-west。

五、InfluxDB 的HTTP API響應

在使用HTTP API時，InfluxDB的響應主要有以下幾個：

1）2xx：204代表no content，200代表InfluxDB可以接收請求但是沒有完成請求。一般會在body體中帶有出錯信息。

2）4xx：InfluxDB不能解析請求。

3）5xx：系統出現錯誤。

?

參考鏈接：https://www.linuxdaxue.com/influxdb-write-data-by-http-api.html

?