行协议
InfluxDB 使用行协议来写入数据点。它是一种基于文本的格式，提供数据点的测量值、标签集、字段集和时间戳。
// Syntax
<measurement>[,<tag_key>=<tag_value>[,<tag_key>=<tag_value>]] <field_key>=<field_value>[,<field_key>=<field_value>] [<timestamp>]
// Example
myMeasurement,tag1=value1,tag2=value2 fieldKey="fieldValue" 1556813561098000000
由换行符 \n 分隔的行表示 InfluxDB 中的单个点。行协议对空格敏感。
行协议不支持标签或字段值中的换行符 \n。
行协议的元素
测量
(必需) 测量名称。 InfluxDB 接受每个点一个测量。 测量名称区分大小写，并受命名限制的约束。
数据类型： 字符串
标签集
可选 – 该点的所有标签键值对。键值关系用 = 运算符表示。多个标签键值对用逗号分隔。 标签键和标签值区分大小写。标签键受命名限制的约束。标签值不能为空；而是从标签集中省略该标签。
字段集
(必需) 该点的所有字段键值对。点必须至少有一个字段。 字段键和字符串值区分大小写。字段键受命名限制的约束。
键数据类型： 字符串
值数据类型： 浮点数 | 整数 | 无符号整数 | 字符串 | 布尔值
始终用双引号引起来字符串字段值。有关引号的更多信息，请参见下面。
measurementName fieldKey="field string value" 1556813561098000000
时间戳
可选 – 数据点的 Unix 时间戳。 InfluxDB 接受每个点一个时间戳。 如果未提供时间戳，则 InfluxDB 使用其主机机器的系统时间（UTC）。
数据类型： Unix 时间戳
关于时间戳的重要说明
- 为确保数据点包含观察到指标的时间（而不是 InfluxDB 接收到的时间），请包含时间戳。
- 如果您的时间戳不是纳秒级的，请在将数据写入 InfluxDB 时指定时间戳的精度。
空格
行协议中的空格确定 InfluxDB 如何解释数据点。第一个未转义的空格将测量值和标签集与字段集分隔开。第二个未转义的空格将字段集与时间戳分隔开。
数据类型和格式
浮点数
IEEE-754 64 位浮点数。 默认数值类型。 InfluxDB 支持浮点字段值中的科学计数法。
浮点字段值示例
myMeasurement fieldKey=1.0
myMeasurement fieldKey=1
myMeasurement fieldKey=-1.234456e+78
整数
带符号的 64 位整数。 数字后面的尾随 i 指定一个整数。
| 最小整数 | 最大整数 |
|---|---|
-9223372036854775808i | 9223372036854775807i |
整数字段值示例
myMeasurement fieldKey=1i
myMeasurement fieldKey=12485903i
myMeasurement fieldKey=-12485903i
无符号整数
无符号 64 位整数。 数字后面的尾随 u 指定一个无符号整数。
| 最小无符号整数 | 最大无符号整数 |
|---|---|
0u | 18446744073709551615u |
无符号整数字段值示例
myMeasurement fieldKey=1u
myMeasurement fieldKey=12485903u
字符串
纯文本字符串。 长度限制为 64KB。
字符串示例
# String measurement name, field key, and field value
myMeasurement fieldKey="this is a string"
布尔值
存储 true 或 false 值。
| 布尔值 | 接受的语法 |
|---|---|
| True | t, T, true, True, TRUE |
| False | f, F, false, False, FALSE |
布尔字段值示例
myMeasurement fieldKey=true
myMeasurement fieldKey=false
myMeasurement fieldKey=t
myMeasurement fieldKey=f
myMeasurement fieldKey=TRUE
myMeasurement fieldKey=FALSE
不要引用布尔字段值。 引用的字段值被解释为字符串。
Unix 时间戳
指定精度的 Unix 时间戳。 默认精度为纳秒 (ns)。
| 最小时间戳 | 最大时间戳 |
|---|---|
-9223372036854775806 | 9223372036854775806 |
Unix 时间戳示例
myMeasurementName fieldKey="fieldValue" 1556813561098000000
引号
行协议支持单引号和双引号，如下表所述
| 元素 | 双引号 | 单引号 |
|---|---|---|
| 测量 | 有限 * | 有限 * |
| 标签键 | 有限 * | 有限 * |
| 标签值 | 有限 * | 有限 * |
| 字段键 | 有限 * | 有限 * |
| 字段值 | 仅限字符串 | 从不 |
| 时间戳 | 从不 | 从不 |
* 行协议接受测量名称、标签键、标签值和字段键中的双引号和单引号，但会将它们解释为名称、键或值的一部分。
特殊字符
行协议支持字符串元素中的特殊字符。 在以下上下文中，它需要使用反斜杠 (\) 转义某些字符
| 元素 | 转义字符 |
|---|---|
| 测量 | 逗号，空格 |
| 标签键 | 逗号、等号、空格 |
| 标签值 | 逗号、等号、空格 |
| 字段键 | 逗号、等号、空格 |
| 字段值 | 双引号，反斜杠 |
您不需要转义其他特殊字符。
行协议中特殊字符的示例
# Measurement name with spaces
my\ Measurement fieldKey="string value"
# Double quotes in a string field value
myMeasurement fieldKey="\"string\" within a string"
# Tag keys and values with spaces
myMeasurement,tag\ Key1=tag\ Value1,tag\ Key2=tag\ Value2 fieldKey=100
# Emojis
myMeasurement,tagKey=🍭 fieldKey="Launch 🚀" 1556813561098000000
转义反斜杠
行协议既支持文字反斜杠，也支持反斜杠作为转义字符。 对于两个连续的反斜杠，第一个被解释为转义字符。 例如
| 反斜杠 | 解释为 |
|---|---|
\ | \ |
\\ | \ |
\\\ | \\ |
\\\\ | \\ |
\\\\\ | \\\ |
\\\\\\ | \\\ |
注释
行协议将行首的 # 解释为注释字符，并忽略该行上该字符之后的所有字符，直到下一个换行符 \n。
# This is a comment
myMeasurement fieldKey="string value" 1556813561098000000
命名限制
测量名称、标签键和字段键不能以下划线 _ 开头。 _ 命名空间保留供 InfluxDB 系统使用。
重复点
一个数据点由测量名称、标签集合和时间戳唯一标识。 如果你提交的行协议具有相同的测量名称、标签集合和时间戳，但具有不同的字段集合，则字段集合将变为旧字段集合和新字段集合的并集，其中任何冲突都优先采用新的字段集合。
此页面是否对您有帮助？
感谢您的反馈！
支持和反馈
感谢您成为我们社区的一员！ 我们欢迎并鼓励您对 InfluxDB 和此文档提供反馈和错误报告。 要获得支持，请使用以下资源
拥有年度合同或支持合同的客户 可以联系 InfluxData 支持。