协议-HTTP API¶

数据库:

shell> show databases;
=>
# curl -G http://localhost:8086/query --data-urlencode "q=SHOW DATABASES"

查询:

curl -G 'https://<ip>:port/query?u=<账号名称>&p=<密码>&pretty=true'
  --data-urlencode "db=mydb" --data-urlencode
    "q=SELECT \"value\" FROM \"cpu_load_short\" WHERE \"region\"='us-west'"

// 多个查询
curl -G 'https://<ip>:port/query?u=<账号名称>&p=<密码>&pretty=true'
  --data-urlencode "db=mydb" --data-urlencode
    "q=SELECT \"value\" FROM \"cpu_load_short\" WHERE \"region\"='us-west';
    SELECT count(\"value\") FROM \"cpu_load_short\" WHERE \"region\"='us-west'"

查询数据时的其它选项:

// 时间戳格式: epoch的值是字符串类型，可以是[h, m, s, ms, u, ns]
curl -G 'https://<网络地址>:3242/query?u=<账号名称>&p=<密码>'
  --data-urlencode "db=mydb" --data-urlencode "epoch=s" --data-urlencode
    "q=SELECT \"value\" FROM \"cpu_load_short\" WHERE \"region\"='us-west'"

// 分块
// 查询参数chunked=true，可以开启分块（Chunking）
// 查询参数chunk_size设为您需要的大小
// 使结果流式批量地返回，而不是一次性全部返回
// 返回的结果可以按时间线或者按每10,000个数据点分块（哪个条件最先满足就以哪个条件来分块）
curl -G 'https://<网络地址>:3242/query?u=<账号名称>&p=<密码>'
  --data-urlencode "db=deluge"
  --data-urlencode "chunked=true"
  --data-urlencode "chunk_size=20000"
  --data-urlencode "q=SELECT * FROM liters"

写入:

// 使用HTTP API将数据写入TSDB For InfluxDB®。
// 向/write路径发送POST请求，并在request body中给出行协议数据：
curl -i -XPOST "https://ip:port/write?db=science_is_cool&u=<账号名称>&p=<密码>"
  --data-binary 'weather,location=us-midwest temperature=82 1465839830100400200'

// 单点写入
curl -i -XPOST 'https://<网络地址>:3242/write?db=mydb&u=<账号名称>&p=<密码>'
  --data-binary 'cpu_load_short,host=server01,region=us-west value=0.64 1434055562000000000'

// 多点写入
curl -i -XPOST 'https://<网络地址>:3242/write?db=mydb&u=<账号名称>&p=<密码>'
  --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
  '

// 文件写入
$> cat cpu_data.txt
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

$> curl -i -XPOST 'https://<ip>:3242/write?db=mydb&u=<账号名称>&p=<密码>' --data-binary @cpu_data.txt