Time Series Database:ラインプロトコルリファレンス

構文

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

各行は 1 つのデータポイントを表します。行は改行 (\n) で区切られます。ラインプロトコルは空白文字の影響を受けます。

例

myMeasurement,tag1=val1,tag2=val2 field1="v1",field2=1i 1465839830100400200

この例では：

• myMeasurement はメジャメント名です

• tag1=val1,tag2=val2 はタグセットです

• field1="v1",field2=1i はフィールドセットです

• 1465839830100400200 はナノ秒単位のタイムスタンプです

要素

データ型

ブール値を書き込む際の構文は、それらをクエリする際の構文とは異なります。詳細については、「よくある質問」をご参照ください。

フィールド値の型は、1 つのシャード内では統一されている必要がありますが、シャード間では異なっていてもかまいません。型の競合が SELECT * クエリにどのように影響するかについては、よくある質問をご参照ください。

データ型の例

1.0 を浮動小数点数として書き込む

> INSERT mymeas value=1

1 を浮動小数点数として書き込む

> INSERT mymeas value=1

接尾辞 i がない数値リテラルは、デフォルトで浮動小数点数です。

-1.234456e+78 を浮動小数点数として書き込む

> INSERT mymeas value=-1.234456e+78

1 を整数として書き込む

> INSERT mymeas value=1i

文字列のフィールド値を書き込む

> INSERT mymeas value="stringing along"

文字列のフィールド値はダブルクォーテーションマークで囲みます。

ブール値のフィールド値を書き込む

> INSERT mymeas value=true

ブール値のフィールド値を引用符で囲まないでください。次の文は true をブール値ではなく、文字列として書き込みます：

> INSERT mymeas value="true"

同一シャード内での型の競合

> 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"}

シャード間での型の競合 (成功)

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

2 つのタイムスタンプが異なるシャードに属する場合、型の競合はエラーを生成しません。

引用符、特殊文字、および追加の命名ガイドライン

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

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

> 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

> 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"

ラインプロトコルデータの書き込み

データベースへのラインプロトコルデータの書き込み手順については、ツールの章をご参照ください。

重複するデータポイント

データポイントは、そのメジャメント名、タグセット、およびタイムスタンプによって一意に識別されます。既存のポイントと同じメジャメント、タグセット、およびタイムスタンプを持つデータポイントを書き込んだ場合：

• 新しいポイントのフィールドセットが既存のポイントと異なる場合、フィールドセットは古いフィールドセットと新しいフィールドセットの和集合になります。

• フィールドキーが競合する場合、新しい値が優先されます。

重複を回避するための例とガイドラインについては、「よくある質問」をご参照ください。

注意事項

• 書き込み前にタグをソートする：Go の bytes.Compare 関数と同じ順序でタグキーによってタグをソートします。タグの順序を一貫させることで、書き込みパフォーマンスが向上します。

• より粗い精度のタイムスタンプを使用する：データ圧縮のパフォーマンスを向上させるために、粗い粒度のタイムスタンプを使用することを推奨します。

• NTP で時計を同期する：TSDB for InfluxDB® は、ホストのローカル UTC 時間を使用してタイムスタンプを割り当てます。ホストの時計が Network Time Protocol (NTP) サーバーと同期されていない場合、書き込まれたデータに不正確なタイムスタンプが付与される可能性があります。

InfluxDB® は InfluxData の登録商標であり、InfluxData は TSDB for InfluxDB® と提携しておらず、また推奨もしていません。