数据的增删改查

摘要

理解curl命令
通过Http API Endpoint写入和查询数据

理解`curl`命令

curl是常用的命令行工具，用来请求Web服务器，它的名字就是客户端（Client）的URL工具的意思

创建数据库

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

使用`curl`通过 CnosDB API 写入数据

CnosDB API是在CnosDB中写入数据的主要方式

写入数据

curl -i -XPOST 'http://localhost:8086/write?db=mydb' --data-binary 'air,station=XiaoMaiDao visibility=50,temperature=63,pressure=52 1568651760000000000'

以文件的方式写入

curl -i -XPOST 'http://localhost:8086/write?db=mydb' --data-binary @air_data.txt

使用`curl`查询CnosDB API

CnosDB API 是在 CnosDB中查询数据的主要方式

如果需要执行查询请求，需要将GET请求发送到/query端点，将URL参数db设置为目标数据库，并将参数q设置为查询语句。还可以通过发送相同的参数作为URL参数或作为带有application/x-www-form-urlencoded的正文的一部分来使用POST请求

示例：

单条查询语句

curl -G "http://localhost:8086/query?pretty=true" --data-urlencode "db=oceanic_station" --data-urlencode "q=SELECT temperature FROM air WHERE station='XiaoMaiDao'"

返回错误

CnosDB返回JSON，查询的结果会在rusults数组中，如果发生错误，CnosDB会设置一个带有error的key

curl -G 'http://localhost:8086/query?pretty=true' --data-urlencode "db=mydb" --data-urlencode "q=SELECT temperature FROM air WHERE station='XiaoMaiDao'"

多条查询语句

多条查询语句需要用;分隔

curl -G 'http://localhost:8086/query?pretty=true' --data-urlencode "db=oceanic_station" --data-urlencode "q=SELECT speed FROM wind WHERE station = 'XiaoMaiDao';SELECT temperature FROM air WHERE station = 'XiaoMaiDao'"

时间精度

CnosDB中的所有内容都以UTC存储和输出。默认情况下，时间戳以RFC3339格式返回，例如 2015-08-04T19:05:00Z，如果想要Unix纪元格式的时间戳，则需要在请求中包含字符串参数：epoch=[h, m, s, ms, u, ns]

curl -G 'http://localhost:8086/query?pretty=true' --data-urlencode "db=oceanic_station" --data-urlencode "epoch=s" --data-urlencode "q=SELECT temperature FROM air WHERE station = 'XiaoMaiDao'"

CnosDB Tutorial