Line protocol reference

InfluxDB 使用 Line Protocol 写入数据点。它是一种基于文本的格式，提供数据点的 measurement、tag set、field set 和 timestamp。

• Line Protocol 的元素
• 数据类型和格式
• 引号
• 特殊字符
• 注释
• 命名限制
• 重复点

// 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 中的单个点。Line Protocol 对空格敏感。

Line Protocol 的元素

Measurement

（必需）measurement 名称。InfluxDB 每个点接受一个 measurement。Measurement 名称区分大小写，并受命名限制约束。

数据类型： 字符串

Tag set

可选 – 点的所有 tag 键值对。键值关系用 = 运算符表示。多个 tag 键值对用逗号分隔。Tag 键和 tag 值区分大小写。Tag 键受命名限制约束。Tag 值不能为空；请改为从 tag set 中省略该 tag。

键数据类型： 字符串
值数据类型： 字符串

Field set

（必需）点的所有 field 键值对。点必须至少有一个 field。Field 键和字符串值区分大小写。Field 键受命名限制约束。

键数据类型： 字符串
值数据类型： Float | Integer | UInteger | 字符串 | Boolean

measurementName fieldKey="field string value" 1556813561098000000

Timestamp

可选 – 数据点的 Unix 时间戳。InfluxDB 每个点接受一个时间戳。如果未提供时间戳，InfluxDB 将使用其主机机器的系统时间 (UTC)。

数据类型： Unix 时间戳

空格

Line Protocol 中的空格决定了 InfluxDB 如何解释数据点。第一个未转义的空格将 measurement 和 tag set 与 field set 分隔开。第二个未转义的空格将 field set 与时间戳分隔开。

数据类型和格式

Float

IEEE-754 64 位浮点数。默认数值类型。InfluxDB 支持 float field 值中的科学计数法。

Float field 值示例

myMeasurement fieldKey=1.0
myMeasurement fieldKey=1
myMeasurement fieldKey=-1.234456e+78

Integer

有符号 64 位整数。数字末尾的 i 指定为整数。

Integer field 值示例

myMeasurement fieldKey=1i
myMeasurement fieldKey=12485903i
myMeasurement fieldKey=-12485903i

UInteger

无符号 64 位整数。数字末尾的 u 指定为无符号整数。

UInteger field 值示例

myMeasurement fieldKey=1u
myMeasurement fieldKey=12485903u

字符串

纯文本字符串。长度限制 64KB。

字符串示例

# String measurement name, field key, and field value
myMeasurement fieldKey="this is a string"

Boolean

存储 true 或 false 值。

Boolean field 值示例

myMeasurement fieldKey=true
myMeasurement fieldKey=false
myMeasurement fieldKey=t
myMeasurement fieldKey=f
myMeasurement fieldKey=TRUE
myMeasurement fieldKey=FALSE

Unix 时间戳

指定精度的 Unix 时间戳。默认精度为纳秒 (ns)。

Unix 时间戳示例

myMeasurementName fieldKey="fieldValue" 1556813561098000000

引号

Line Protocol 支持单引号和双引号，如下表所述

^* Line Protocol 接受 measurement 名称、tag 键、tag 值和 field 键中的双引号和单引号，但将其解释为名称、键或值的一部分。

特殊字符

Line Protocol 支持字符串元素中的特殊字符。在以下上下文中，它要求使用反斜杠 (\) 转义某些字符

您无需转义其他特殊字符。

Line Protocol 中特殊字符的示例

# 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

转义反斜杠

Line Protocol 同时支持字面反斜杠和作为转义字符的反斜杠。对于两个连续的反斜杠，第一个被解释为转义字符。例如

注释

Line Protocol 将行首的 # 解释为注释字符，并忽略所有后续字符，直到下一个换行符 \n。

# This is a comment
myMeasurement fieldKey="string value" 1556813561098000000

命名限制

Measurement 名称、tag 键和 field 键不能以下划线 _ 开头。_ 命名空间为 InfluxDB 系统使用保留。

重复点

点由 measurement 名称、tag set 和时间戳唯一标识。如果您提交具有相同 measurement、tag set 和时间戳，但具有不同 field set 的 Line Protocol，则 field set 将成为旧 field set 和新 field set 的并集，其中任何冲突都倾向于新的 field set。