行協議

語法

<measurement>[,<tag_key>=<tag_value>[,<tag_key>=<tag_value>]] <field_key>=<field_value>[,<field_key>=<field_value>] [<timestamp>]

使用換行符\n分隔每一行，每一行表示TSDB For InfluxDB?中的一個數據點。行協議是對空格敏感的。

語法描述

行協議告訴TSDB For InfluxDB?數據的measurement、tag set、field set和時間戳。

數據類型

寫入和查詢布爾值的語法

寫入和查詢布爾值的語法不一樣。請查看FAQ獲得更多相關信息。

field type差異

在measurement中，一個field的數據類型在一個shard內不會不一致，但是在不同的shard，它的數據類型可以不同。若想了解field value的數據類型差異如何影響SELECT *查詢，請參見FAQ的相關章節。

示例

示例一：將field value 1.0作為浮點數寫入TSDB For InfluxDB?

> INSERT mymeas value=1.0

示例二：將field value 1作為浮點數寫入TSDB For InfluxDB?

> INSERT mymeas value=1

示例三：將field value -1.234456e+78作為浮點數寫入TSDB For InfluxDB?

> INSERT mymeas value=-1.234456e+78

TSDB For InfluxDB?支持使用科學計數法指定field value。

示例四：將field value 1作為整數寫入TSDB For InfluxDB?

> INSERT mymeas value=1i

示例五：將field value stringing along作為字符串寫入TSDB For InfluxDB?

> INSERT mymeas value="stringing along"

始終使用雙引號將字符串類型的field value括起來。更多關于引號的介紹，請查看下文引號一節。

示例六：將field value true作為布爾值寫入TSDB For InfluxDB?

> INSERT mymeas value=true

請不要用引號將布爾類型的field value括起來。以下語句把true作為字符串寫入TSDB For InfluxDB?：

> INSERT mymeas value="true"

示例七：嘗試將字符串寫入之前接受浮點數的field

如果浮點數和字符串上的時間戳存儲在同一個shard：

> INSERT mymeas value=3 1465934559000000000
> INSERT mymeas value="stringing along" 1465934559000000001
ERR: {"error":"field type conflict: input field \"value\" on measurement \"mymeas\" is type string, already exists as type float"}

如果浮點數和字符串上的時間戳不是存儲在同一個shard：

> INSERT mymeas value=3 1465934559000000000
> INSERT mymeas value="stringing along" 1466625759000000000
>

引號、特殊字符和其它命名指南

引號

• 行協議允許用戶使用雙引號和單引號將measurement的名字、tag key、tag value和field key括起來。然而，它會把雙引號和單引號當作是名字、key或value的一部分。這會使查詢語法復雜化（請看下面的示例）。

示例

示例一：無效的行協議 - 用雙引號將時間戳括起來

> INSERT mymeas value=9 "1466625759000000000"
ERR: {"error":"unable to parse 'mymeas value=9 \"1466625759000000000\"': bad timestamp"}

用雙引號（或單引號）將時間戳括起來，會產生bad timestamp錯誤。

示例二：語義錯誤 - 用雙引號將布爾類型的field value括起來

> INSERT mymeas value="true"
> SHOW FIELD KEYS FROM "mymeas"
name: mymeas
------------
fieldKey         fieldType
value            string

TSDB For InfluxDB?假設所有用雙引號括起來的field value都是字符串。

示例三：語義錯誤 - 用雙引號將measurement的名字括起來

> INSERT "mymeas" value=200
> SHOW MEASUREMENTS
name: measurements
------------------
name
"mymeas"
> SELECT * FROM mymeas
> SELECT * FROM "mymeas"
> SELECT * FROM "\"mymeas\""
name: "mymeas"
--------------
time                                                    value
2016-06-14T20:36:21.836131014Z   200

如果您使用雙引號將行協議中的measurement括起來，那么對該measurement的任意查詢都需要在FROM子句中使用雙引號并且將雙引號轉義（\）。

特殊字符

對于tag key、tag value和field key，始終使用反斜杠\來轉義：

• 逗號 ,

• 等號 =

• 空格

對于measurement，始終使用反斜杠\來轉義：

• 逗號 ,

• 空格

對于字符串類型的field value，使用反斜杠\來轉義：

• 雙引號 "

行協議不需要用戶將反斜杠\轉義。用戶也不需要將其它的特殊字符轉義。

示例

示例一：寫入帶特殊字符的數據點

> INSERT "measurement\ with\ quo??es\ and\ emoji",tag\ key\ with\ sp??ces=tag\,value\,with"commas" field_k\ey="string field value, only \" need be esc??ped"

系統寫入一個數據點，其measurement為"measurement with quo??es and emoji"，tag key為tag key with sp??ces，tag value為tag,value,with"commas"，field key為field_k\ey，field value為string field value, only " need be esc??ped。

其它命名指南

在行的開頭，#是行協議的有效注釋字符。TSDB For InfluxDB?會忽略所有的后續字符，直到遇到下一個換行符\n。

measurement的名字、tag key、tag value、field key和field value都是大小寫敏感的。

行協議將InfluxQL關鍵字作為標識符名字。通常，我們建議避免在schema中使用InfluxQL關鍵字，因為它可能會在查詢數據時引起混淆。

關鍵字time是一個特例。time可以是一個連續查詢名字、數據庫名字、measurement的名字、保留策略名字、subscription的名字和用戶名。在這些情況下，不需要在查詢中用雙引號將time括起來。time不能是field key或tag key；TSDB For InfluxDB?拒絕寫入將time作為field key或tag key的數據，對于這種數據寫入，TSDB For InfluxDB?會返回錯誤。請參見FAQ獲得更多相關信息。

在實踐中的行協議

關于如何將行協議數據寫入數據庫，請查看工具章節。

重復數據點

measurement的名字、tag set和時間戳唯一標識一個數據點。如果您提交的數據具有相同measurement、tag set和時間戳但具有不同field set，那么數據的field set會變為舊field set和新field set的并集，如果有任何沖突以新field set為準。

有關此行為的完整示例和如何避免這種情況，請參見FAQ相關章節。

InfluxDB? is a trademark registered by InfluxData, which is not affiliated with, and does not endorse, TSDB for InfluxDB?.