时序数据库 | InfluxDB - 行协议

目录

零、行协议定义

一、measurement（测量名称） 

二、Tag Set（标签集）

三、Field Set（字段集）

四、空格

五、协议中的数据类型及其格式

Float（浮点数） 

Integer（整数）

UInteger（无符号整数）

String（字符串）

Boolean（布尔值）

Unix Timestamp（Unix 时间戳）

注释

---

零、行协议定义

InfluxDB 行协议是 InfluxDB 数据库独创的一种数据格式，它由纯文本构成，只要数据符合这种格式，就能使用 InfluxDB 的 HTTP API 将数据写入数据库。 

与 CSV 相似，在 InfluxDB 行协议中，一条数据和另一条数据之间使用换行符分隔，所以一行就是一条数据。另外，在时序数据库领域，一行数据一行数据由下面 4 种元素构
成。 

• measurement（测量名称） 
• Tag Set（标签集） 
• Field Set（字段集） 
• Timestamp（时间戳）

---

一、measurement（测量名称） 

必需，测量的名称。 你可以将它当作普通关系型数据的 table，虽然实际上不是这么回事。 在 InfluxDB 行协议中，测量名称不可省略。 大小写敏感，不可以用下划线_打头 

---

二、Tag Set（标签集）

标签应该用在一些值的范围有限（可枚举）的，不太会变动的属性上。比如传感器的类型和 id 等等。在 InfluxDB 中一个 Tag 相当于一个索引。给数据点加上 Tag 有利于将来对数据进行检索。但是如果索引太多了，就会减慢数据的插入速度。可选，键值关系使用=表示。多个键值对之间使用英文逗号分隔，标签的键和值都区分大小写。标签的键不能以下划线 _ 开头键的数据类型：字符串值的数据类型：字符串 

---

三、Field Set（字段集）

必需，一个数据点上所有的字段键值对，键是字段名，值是数据点的值。一个数据点至少要有一个字段。字段集的键是大小写敏感的。键的数据类型：字符串。值的数据类型：浮点数 | 整数 | 无符号整数 | 字符串 | 布尔值

---

四、空格

行协议中的空格决定了 InfluxDB 如何解释数据点，第一个未转义的空格将测量值&Tag Set（标签集）与 Field Set（字段集）分开。第二个未转义空格将 Field Set（字段级）和时间戳分开。