Time Series Database:Referensi protokol baris

Sintaks

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

Setiap baris merepresentasikan satu titik data dan dipisahkan oleh line feed (\n). Protokol baris sensitif terhadap spasi.

Contoh

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

Pada contoh ini:

• myMeasurement adalah nama measurement

• tag1=val1,tag2=val2 adalah tag set

• field1="v1",field2=1i adalah field set

• 1465839830100400200 adalah stempel waktu dalam nanodetik.

Elemen

Tipe data

Sintaks penulisan nilai Boolean berbeda dengan sintaks saat mengkuerinya. Untuk informasi lebih lanjut, lihat FAQ.

Tipe nilai field harus konsisten dalam satu shard, tetapi dapat berbeda antar shard. Mengenai bagaimana konflik tipe memengaruhi kueri SELECT *, lihat FAQ.

Contoh tipe data

Tuliskan 1.0 sebagai float

> INSERT mymeas value=1

Menulis 1 sebagai float

> INSERT mymeas value=1

Literal numerik tanpa akhiran i secara bawaan merupakan tipe float.

Menulis -1.234456e+78 sebagai float

> INSERT mymeas value=-1.234456e+78

Menulis 1 sebagai integer

> INSERT mymeas value=1i

Menulis nilai field berupa string

> INSERT mymeas value="stringing along"

Nilai field berupa string harus diapit tanda kutip ganda.

Menulis nilai field Boolean

> INSERT mymeas value=true

Jangan membungkus nilai field Boolean dengan tanda kutip. Pernyataan berikut menulis true sebagai string, bukan Boolean:

> INSERT mymeas value="true"

Konflik tipe dalam shard yang sama

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

Konflik tipe antar shard (berhasil)

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

Ketika dua timestamp tersebut berada di shard yang berbeda, konflik tipe tidak menghasilkan error.

Tanda kutip, karakter khusus, dan panduan penamaan tambahan

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

Menulis data protokol baris

Untuk petunjuk menulis data protokol baris ke database, lihat bab Tools.

Titik data duplikat

Sebuah titik data diidentifikasi secara unik berdasarkan nama measurement, tag set, dan timestamp-nya. Jika Anda menulis titik data dengan measurement, tag set, dan timestamp yang sama dengan titik yang sudah ada:

• Jika titik baru memiliki field set yang berbeda dari titik yang sudah ada, field set-nya menjadi gabungan (union) dari field set lama dan baru.

• Jika terjadi konflik pada kunci field, nilai baru akan menggantikan nilai lama.

Untuk contoh dan panduan menghindari duplikasi, lihat FAQ.

Catatan penggunaan

• Urutkan tag sebelum menulis: Urutkan tag berdasarkan kunci tag menggunakan urutan yang sama seperti fungsi Go bytes.Compare. Pengurutan tag yang konsisten meningkatkan performa penulisan.

• Gunakan presisi timestamp yang lebih kasar: Kami menyarankan menggunakan timestamp bergranularitas kasar untuk meningkatkan performa kompresi data.

• Sinkronkan jam dengan NTP: TSDB for InfluxDB® menggunakan waktu UTC lokal host untuk memberikan timestamp. Jika jam host tidak disinkronkan dengan server Network Time Protocol (NTP), data yang ditulis mungkin memiliki timestamp yang tidak akurat.

InfluxDB® adalah merek dagang terdaftar milik InfluxData, yang tidak berafiliasi dengan, dan tidak mendukung, TSDB for InfluxDB®.