Time Series Database：CLI dari TSDB untuk InfluxDB®

Deskripsi Parameter

• -ssl: Menentukan bahwa server TSDB untuk InfluxDB® terhubung melalui HTTPS.

• -username: Menentukan nama pengguna untuk login ke instansi TSDB untuk InfluxDB® Anda.

• -password: Menentukan kata sandi untuk login ke instansi TSDB untuk InfluxDB® Anda.

• -host: Menentukan titik akhir instansi TSDB untuk InfluxDB® Anda. Ganti ts-xxxxxx dengan ID instansi TSDB untuk InfluxDB® Anda.

• -port: Menentukan port jaringan. Jika terhubung melalui virtual private cloud (VPC), atur parameter ini ke 8086. Jika terhubung melalui Internet, atur parameter ini ke 3242.

Setelah CLI influx dimulai, Anda dapat menjalankan pernyataan InfluxQL atau perintah CLI di terminal. Untuk menjalankan pernyataan Flux, setel parameter -type ke flux. Gunakan perintah help untuk melihat daftar perintah yang tersedia. Untuk menghentikan query InfluxQL yang sedang berjalan, tekan Ctrl+C.

Variabel Lingkungan

Anda dapat mengonfigurasi variabel lingkungan berikut untuk klien influx. Variabel dapat ditulis dalam huruf kecil atau besar, namun huruf besar lebih disarankan.

HTTP_PROXY

Menentukan server proxy yang digunakan untuk HTTP.

Format: [protocol://][:port]

HTTP_PROXY=http://localhost:1234

HTTPS_PROXY

Menentukan server proxy yang digunakan untuk HTTPS. Jika kedua variabel HTTP_PROXY dan HTTPS_PROXY disetel, HTTPS_PROXY memiliki prioritas.

Format: [protocol://][:port]

HTTPS_PROXY=https://localhost:1443

NO_PROXY

Menentukan host yang tidak menggunakan proxy. Jika variabel ini disetel ke asterisk (*), semua host tidak menggunakan proxy.

Format: Daftar host dipisahkan koma.

NO_PROXY=123.45.67.89,123.45.67.90

Flag influx

Saat memulai influx, Anda dapat melewatkan flag ke influx. Jalankan perintah $ influx --help untuk melihat semua flag yang tersedia. Bagian ini memberikan deskripsi singkat untuk setiap flag yang didukung oleh influx, serta penjelasan rinci tentang cara menggunakan flag -execute, -format, dan -import.

-compressed

Gunakan flag ini jika file impor dikompresi. Flag -compressed harus digunakan bersamaan dengan flag -import.

Menentukan tingkat konsistensi penulisan.

-database 'nama database'

Menentukan database ke mana CLI influx terhubung.

-execute '<perintah>'

Menjalankan perintah InfluxQL lalu keluar.

-format 'jsoncsvcolumn'

Menentukan format respons server.

-host '<hostname>'

Menentukan host ke mana CLI influx terhubung.

-import

Mengimpor data baru dari file atau mengimpor data basis data yang sebelumnya diekspor dari file.

-password '<kata sandi>'

Menentukan kata sandi yang digunakan CLI influx untuk terhubung ke server. Jika flag -password tidak disetel, influx akan meminta Anda memasukkan kata sandi. Anda juga dapat menggunakan variabel lingkungan INFLUX_PASSWORD untuk menentukan kata sandi.

-path

Menentukan jalur file yang akan diimpor. Flag -path harus digunakan bersamaan dengan flag -import.

-port 'nomor port'

Menentukan port ke mana CLI influx terhubung. Secara default, TSDB untuk InfluxDB® menggunakan port 3242.

-pps

Menentukan jumlah titik data yang dapat diimpor per detik. Secara default, flag -pps diatur ke 0 dan influx tidak membatasi kecepatan impor data. Flag -pps harus digunakan bersamaan dengan flag -import.

-precision 'rfc3339hmsmsuns'

-pretty

Mengaktifkan pencetakan keluaran cantik untuk data berformat JSON guna meningkatkan keterbacaan.

-ssl

Menggunakan HTTPS untuk permintaan.

-type

Menentukan shell interaktif yang ingin digunakan. Nilai default adalah influxql. Untuk menggunakan shell Flux Read-Eval-Print Loop (REPL), setel flag -type ke flux.

-username 'nama pengguna'

Menentukan nama pengguna yang digunakan CLI influx untuk terhubung ke server. Anda juga dapat menggunakan variabel lingkungan INFLUX_USERNAME untuk menentukan nama pengguna.

-version

Menampilkan versi TSDB untuk InfluxDB® lalu keluar.

Jalankan perintah InfluxQL dan keluar menggunakan -execute

Untuk menanyakan data dari semua basis data yang tersedia, jalankan query berikut:

$ influx -ssl -username <Nama Pengguna> -password <Kata Sandi> -host <Titik Akhir> -port 3242 -execute 'SHOW DATABASES'
name: databases
---------------
name
NOAA_water_database
_internal
telegraf
pirates

Untuk menanyakan data dari basis data tertentu dan mengubah presisi timestamp pada saat yang sama, jalankan query berikut:

$ influx -ssl -username <Nama Pengguna> -password <Kata Sandi> -host <Titik Akhir> -port 3242 -execute 'SELECT * FROM "h2o_feet" LIMIT 3' -database="NOAA_water_database" -precision=rfc3339
name: h2o_feet
--------------
time                     level description     location      water_level
2015-08-18T00:00:00Z     below 3 feet          santa_monica  2.064
2015-08-18T00:00:00Z     between 6 and 9 feet  coyote_creek  8.12
2015-08-18T00:06:00Z     between 6 and 9 feet  coyote_creek  8.005

Tentukan format respons server menggunakan -format

Format default adalah column.

$ influx -ssl -username <Nama Pengguna> -password <Kata Sandi> -host <Titik Akhir> -port 3242 -format=column
[...]
> SHOW DATABASES
name: databases
---------------
name
NOAA_water_database
_internal
telegraf
pirates

Ubah format menjadi csv.

$ influx -ssl -username <Nama Pengguna> -password <Kata Sandi> -host <Titik Akhir> -port 3242 -format=csv
[...]
> SHOW DATABASES
name,name
databases,NOAA_water_database
databases,_internal
databases,telegraf
databases,pirates

Ubah format menjadi json.

$ influx -ssl -username <Nama Pengguna> -password <Kata Sandi> -host <Titik Akhir> -port 3242 -format=json
[...]
> SHOW DATABASES
{"results":[{"series":[{"name":"databases","columns":["name"],"values":[["NOAA_water_database"],["_internal"],["telegraf"],["pirates"]]}]}]}

Ubah format menjadi json dan aktifkan pencetakan keluaran cantik.

$ influx -ssl -username <Nama Pengguna> -password <Kata Sandi> -host <Titik Akhir> -port 3242 -format=json -pretty
[...]
> SHOW DATABASES
{
    "results": [  
        {
            "series": [
                {
                    "name": "databases",
                    "columns": [
                        "name"
                    ],
                    "values": [
                        [
                            "NOAA_water_database"                       
                        ],
                        [
                            "_internal"
                        ],
                        [
                            "telegraf"
                        ],
                        [
                            "pirates"
                        ]
                    ]
                }
            ]
        }
    ]
}

Impor data dari file menggunakan -import

Contoh:

Misalkan sebuah basis data bernama pirates dan kebijakan retensi bernama oneday telah dibuat.

File datarrr.txt:

# DML
# CONTEXT-DATABASE: pirates
# CONTEXT-RETENTION-POLICY: oneday
treasures,captain_id=dread_pirate_roberts value=801 1439856000
treasures,captain_id=flint value=29 1439856000
treasures,captain_id=sparrow value=38 1439856000
treasures,captain_id=tetra value=47 1439856000
treasures,captain_id=crunch value=109 1439858880

Perintah:

$influx -ssl -username <Nama Pengguna> -password <Kata Sandi> -host <Titik Akhir> -port 3242 -import -path=datarrr.txt -precision=s

Hasil:

2015/12/22 12:25:06 Processed 0 commands
2015/12/22 12:25:06 Processed 5 inserts
2015/12/22 12:25:06 Failed 0 inserts

Sebelum menggunakan -import, perhatikan hal berikut:

• -pps

  Anda dapat menggunakan flag -pps untuk menentukan jumlah titik data yang dapat diimpor per detik. Pengaturan ini diterapkan saat titik data ditulis ke basis data. Secara default, flag -pps diatur ke 0.

  influx

  tidak membatasi kecepatan impor data.

• Anda dapat mengimpor data dari file .gz dengan menyertakan flag berikut:

  -compressed.

  .

• Anda harus menyediakan timestamp untuk titik data dalam file. Jika tidak, TSDB untuk InfluxDB® akan menetapkan timestamp yang sama untuk titik data tanpa timestamp. Ini dapat menyebabkan penimpaan data yang tidak diinginkan.

• Jika file data Anda berisi lebih dari 5.000 titik data, Anda mungkin perlu membagi file menjadi beberapa file yang lebih kecil. Ini memungkinkan Anda menulis data ke TSDB untuk InfluxDB® dalam batch. Kami merekomendasikan menyertakan 5.000 hingga 10.000 titik data dalam setiap batch. Jika Anda menyertakan jumlah titik data yang lebih kecil dalam setiap batch, sejumlah permintaan HTTP yang lebih besar harus dikirim, yang mengurangi performa. Secara default, periode timeout untuk setiap permintaan HTTP adalah lima detik. TSDB untuk InfluxDB® mencoba menulis titik data setelah timeout permintaan, tetapi titik tersebut mungkin gagal ditulis.

Perintah influx