Lakukan operasi data pada tabel deret waktu menggunakan antarmuka baris perintah - Tablestore

Tulis, impor, dan kueri data deret waktu serta kelola timeline dengan CLI.

Prasyarat

CLI dengan kredensial akses yang telah dikonfigurasi. Untuk informasi selengkapnya, lihat Tablestore CLI.
Tabel deret waktu. Untuk informasi selengkapnya, lihat Operasi tabel deret waktu.

Sebelum menulis, mengimpor, atau mengkueri data, pilih tabel deret waktu target:

use --ts -t <tableName>

Tulis data deret waktu

Tulis satu baris data deret waktu ke timeline tertentu.

putts --k '<timeseriesKey>' --field '<fields_json>' --time <timestamp>

Parameter	Wajib	Deskripsi
--k	Ya	Identifikasi timeline, direpresentasikan sebagai array JSON dalam format `["measurement","dataSource",["tag1=value1","tag2=value2"]]`. Array tersebut mencakup: Elemen pertama: nama measurement. Elemen kedua: identifikasi sumber data. Elemen ketiga: array tag. Setiap tag berada dalam format tagKey=tagValue.
--field	Ya	Bidang data, direpresentasikan sebagai array JSON. Setiap elemen berisi properti berikut: c (wajib): nama kolom. v (wajib): nilai kolom. Tipe yang didukung: string, Boolean, integer, dan bilangan titik mengambang. isint (opsional): atur ke `true` untuk memperlakukan nilai sebagai integer. Nilai default adalah `false` (bilangan titik mengambang).
--time	Ya	Timestamp baris data, dalam mikrodetik (μs).

Contoh

Tulis metrik CPU untuk host yang dipantau di Wilayah Hangzhou:

putts --k '["cpu","localhost",["region=hangzhou","os=ubuntu"]]' --field '[{"c":"usage_user","v":58,"isint":true},{"c":"usage_idle","v":24,"isint":true}]' --time 1635162859000000

Impor data deret waktu

Impor data deret waktu dari file lokal ke dalam tabel deret waktu.

Windows

import_timeseries --input D:\\localpath\\filename.txt

Linux dan macOS

import_timeseries --input /localpath/filename.txt

Parameter	Wajib	Deskripsi
-i, --input	Ya	Jalur ke file data lokal.

Setiap baris dalam file data merepresentasikan satu baris data deret waktu dalam format measurement_name,tags fields timestamp.

Bidang	Wajib	Deskripsi
measurement_name	Ya	Nama measurement.
tags	Ya	Setiap tag berada dalam format tagKey=tagValue. TagValue dari tag pertama digunakan sebagai identifikasi sumber data.
fields	Ya	Bidang data dalam format fieldKey=fieldValue. Tambahkan `i` pada nilai numerik untuk menandakan integer. Nilai tanpa `i` secara default dianggap sebagai bilangan titik mengambang.
timestamp	Ya	Timestamp dalam nanodetik (ns). Nilai ini secara otomatis dikonversi ke mikrodetik setelah diimpor.

Contoh file data:

cpu,hostname=host_0,region=cn-hangzhou usage_user=58i,usage_system=2i,usage_idle=24i 1609459200000000000
cpu,hostname=host_1,region=cn-hangzhou usage_user=58i,usage_system=2i,usage_idle=24i 1609459200000000000

Contoh

Impor data deret waktu dari file lokal:

import_timeseries --input /tmp/import_timeseries.txt

Kueri data deret waktu

Kueri data deret waktu untuk timeline tertentu dalam rentang waktu tertentu.

getts --k '<timeseriesKey>' --time_start <start> --time_end <end> --limit <n>

Parameter	Wajib	Deskripsi
--k	Ya	Identifikasi timeline, dalam format yang sama dengan `--k` pada bagian Tulis data deret waktu.
--time_start	Ya	Waktu mulai kueri, sebagai timestamp dalam mikrodetik.
--time_end	Ya	Waktu akhir kueri, sebagai timestamp dalam mikrodetik.
--limit	Tidak	Jumlah maksimum baris yang dikembalikan. Nilai valid: 1 hingga 5000.

Contoh

getts --k '["cpu","localhost",["region=hangzhou","os=ubuntu"]]' --time_start 0 --time_end 1667638230000000 --limit 100

Cari timeline

Cari timeline yang sesuai dengan kondisi tertentu. Singkatan perintah ini adalah qtm.

query_ts_meta --measurement <measurement> --datasource <dataSource> --limit <n>

Parameter	Wajib	Deskripsi
--measurement	Tidak	Nama measurement.
--datasource	Tidak	Identifikasi sumber data.
--limit	Tidak	Jumlah maksimum baris yang dikembalikan. Nilai valid: 1 hingga 1000. Server mungkin mengembalikan lebih sedikit baris daripada batas yang ditentukan.
-e, --edit	Tidak	Definisikan filter pencarian kompleks dalam format JSON. Jenis filter yang didukung: COMPOSITE, MEASUREMENT, SOURCE, dan TAG.

Contoh

Cari timeline dengan nama measurement cpu dan identifikasi sumber data localhost.

query_ts_meta --measurement cpu --datasource localhost --limit 10

Untuk mendefinisikan filter pencarian kompleks, gunakan qtm -e. Contoh filter:

{
    "Type":"COMPOSITE",
    "QueryCondition":{
        "Operator":"AND",
        "SubConditions":[
            {
                "Type":"MEASUREMENT",
                "QueryCondition":{
                    "Operator":"EQUAL",
                    "Value":"CPU"
                }
            },
            {
                "Type":"SOURCE",
                "QueryCondition":{
                    "Operator":"EQUAL",
                    "Value":"127.0.0.1"
                }
            },
            {
                "Type":"TAG",
                "QueryCondition":{
                    "Operator":"GREATER_EQUAL",
                    "TagName":"Region",
                    "Value":"Jiangning"
                }
            }
        ]
    }
}

Pindai timeline

Ambil semua atau sejumlah timeline terbatas dari tabel deret waktu. Singkatan perintah ini adalah qtm.

query_ts_meta --limit <n>

Parameter	Wajib	Deskripsi
--limit	Tidak	Jumlah maksimum baris yang dikembalikan. Jika tidak ditentukan, semua timeline dipindai.

Contoh

query_ts_meta --limit 10

Perbarui timeline

Perbarui atribut timeline. Jika timeline target tidak ada, perintah ini akan membuatnya. Singkatan perintah ini adalah utm.

update_ts_meta --k '<timeseriesKey>' --attrs '<attributes>'

Parameter	Wajib	Deskripsi
--k	Ya	Identifikasi timeline, dalam format yang sama dengan `--k` pada bagian Tulis data deret waktu.
--attrs	Tidak	Atribut timeline, direpresentasikan sebagai array JSON. Setiap atribut berada dalam format key=value.

Contoh

Atur atribut kota dan wilayah untuk host yang dipantau:

update_ts_meta --k '["cpu","localhost",["region=hangzhou","os=ubuntu"]]' --attrs '["city=nanjing","region=jiangning"]'