行协议写入是以文本的格式写入,用于将数据点写入数据库中,兼容InfluxDB行协议格式。本文介绍行协议写入的语法说明和示例。

数据类型

行协议写入语法的数据类型包括Float、Integer、String、Boolean和Timestamp。数据类型说明参见下表。

数据类型 说明
Float 默认解析类型,例如1、1.0、1.e+78、1.E+78。
Integer 支持64位整数,通过后缀i来识别,例如12i、101i。
String 字符串类型,使用双引号“”表示,例如“hello world”。
Boolean 取值包括True和False。
  • True支持的语法包括t、T、true、True、TRUE。
  • False支持的语法包括f、F、false、False、FALSE。
Timestamp 时间戳。Timestamp目前协议上支持ns,数据存储时转换为ms存储。如果您需要修改时间戳精度,可通过precision来选择。

语法

<table_name>[,<tag_key>=<tag_value>[,<tag_key>=<tag_value>]] <field_key>=<field_value>[,<field_key>=<field_value>] [<timestamp>] 
说明 一次写入多条数据用反斜线n(\n)分割。

参数说明

参数 是否必选 说明
table_name 数据写入的表名。
tag_set 数据标签,可用于搜索。
field_set 数据字段。
timestamp 时间戳,默认为当前时间,默认单位为ns。如果您需要修改时间戳精度,可通过precision来选择。
precision 默认值ns,时间戳精度,取值包括n、u、ms、s、m、h。

请求路径和方法

请求路径 请求方法 描述
/api/v2/write POST 行协议写入。

示例

行协议写入的语句示例如下。

POST /api/v2/write?precision=ms
sensor,device_id=F07A1260,region=north-cn temperature=12.1,humidity=45 1619076780000
sensor,device_id=F07A1260,region=north-cn temperature=13.2,humidity=47 1619076790000
sensor,device_id=F07A1260,region=north-cn temperature=10.6,humidity=46 1619076800000
sensor,device_id=F07A1260,region=north-cn temperature=18.1,humidity=44 1619076780000
sensor,device_id=F07A1260,region=north-cn temperature=19.7,humidity=44 1619076790000
说明 行协议写入成功后返回状态码204。