首页/数据/NoSQL 速查/行协议转义规则

行协议转义规则

行协议对特殊字符有转义要求:measurement、tag 键值与字段键中的逗号、空格、等号要反斜杠转义;字符串字段值还需转义双引号与反斜杠。

NoSQL 速查数据更新于 2026-10-12
需要转义, 空格 = 出现在 measurement / tag key / tag value / field key 中
字符串值双引号内部转义 \" 与 \\;换行不能出现在行协议中
反例tag 值带空格未转义会解析成字段部分,写入报错或字段错位

示例

示例
# tag 值含空格与等号,使用反斜杠转义
sensor,location=room\ 1,unit=\°C value=21.5 1719792000000000000

# 字符串 field 值中的双引号
events,tag=a message="say \"hi\"" 1719792000000000000
客户端库通常已处理转义;手写或 CSV 转换脚本导出时必须自己处理,否则会出现明细写入失败。

易错点

  • 只对 tag 转义忘了 field key 也会解析失败,两类键值的规则要统一处理
  • Windows 路径的反斜杠放进字符串字段时容易被二次转义,建议用工具库而非手拼

数据来源与参考

  • InfluxData Docs: Line protocol (special characters)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌