Lakukan operasi pada data dalam tabel deret waktu menggunakan CLI Tablestore - Tablestore

CLI Tablestore memungkinkan Anda menulis dan mengimpor data deret waktu ke tabel deret waktu, serta menanyakan data deret waktu dalam tabel tersebut. Anda juga dapat menggunakan CLI Tablestore untuk mengambil, memindai, dan memperbarui data deret waktu.

null

Sebelum melakukan operasi data pada tabel deret waktu, pastikan tabel tersebut telah digunakan. Untuk informasi lebih lanjut, lihat Gunakan tabel deret waktu.

Tulis data deret waktu

Tulis data deret waktu ke tabel deret waktu.

Sintaksis Perintah

putts --k '["measurement_name","data_source",["tagKey1=tagValue1","tagKey2=tagValue2"]]' --field '[{"c":"fieldname","v":"fieldvalue"},{"c":"bool_field","v":true},{"c":"double_field","v":1.1},{"c":"int_value","v":10,"isint":true}]' --time 1635162859000000

Tabel berikut menjelaskan parameter dalam perintah.

Parameter	Diperlukan	Contoh	Deskripsi
--k	Ya	'["cpu","localhost",["region=hangzhou","os=ubuntu"]]'	Pengidentifikasi deret waktu. Nilai parameter ini adalah array yang berisi konten berikut: Nama pengukuran: nama metrik. Dalam contoh ini, nama metrik adalah cpu. Sumber data: sumber data dari mana data dihasilkan. Dalam contoh ini, sumber data adalah localhost. Tag: tag. Nilainya adalah array di mana setiap tag terdiri dari tagKey dan tagValue dalam format tagKey=tagValue.
--field	Ya	'[{"c":"fieldname","v":"fieldvalue"},{"c":"bool_field","v":true},{"c":"double_field","v":1.1},{"c":"int_value","v":10,"isint":true}]'	Kolom data dari data deret waktu, dalam format JSON dan berisi konten berikut: c: Parameter ini diperlukan dan menentukan nama kolom data. v: Parameter ini diperlukan dan menentukan nilai kolom data. Nilai parameter ini bisa bertipe string, numerik, atau Bool. isint: Parameter ini opsional dan menentukan apakah nilai kolom data numerik dikonversi menjadi nilai tipe integer. Nilai parameter ini bertipe Bool. Nilai valid: true dan false. Nilai defaultnya adalah false, yang menentukan bahwa nilai kolom data numerik dikonversi menjadi nilai tipe floating-point. Jika Anda mengatur parameter ini ke true, nilai kolom data numerik dikonversi menjadi nilai tipe integer.
--time	Tidak	1635162859000000	Waktu saat baris data deret waktu dihasilkan. Nilai parameter ini adalah timestamp. Unit: mikrodetik (μs).

Contoh

Masukkan satu baris data deret waktu.

putts --k '["cpu","localhost",["region=hangzhou","os=ubuntu"]]' --field '[{"c":"fieldname","v":"fieldvalue"},{"c":"bool_field","v":true},{"c":"double_field","v":1.1},{"c":"int_value","v":10,"isint":true}]' --time 1635162859000000

Impor data deret waktu

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

Sintaksis Perintah

Windows

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

Linux dan macOS

import_timeseries --input /localpath/filename.txt

Tabel berikut menjelaskan parameter dalam perintah.
Parameter
Diperlukan
Contoh
Deskripsi
-i, --input
Ya
/temp/import_timeseries.txt
File konfigurasi dari mana Anda ingin mengimpor data deret waktu.

Kode sampel berikut memberikan contoh isi file konfigurasi:

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

Setiap baris dalam file konfigurasi adalah satu baris data deret waktu dalam format measurement_name,tags fields timestamp. Tabel berikut menjelaskan parameter.

Parameter	Diperlukan	Contoh	Deskripsi
measurement_name	Ya	cpu	Tipe metrik.
tags	Ya	hostname=host_0,region=cn-hangzhou	Tag. Setiap tag terdiri dari tagKey dan tagValue dalam format tagKey=tagValue. tagValue dari tag pertama menentukan sumber data dari mana data dihasilkan. Dalam contoh ini, host_0 menentukan sumber data dari data deret waktu dalam baris.
fields	Ya	usage_user=58i,usage_system=2i,usage_idle=24i	Kolom data dari data deret waktu. Setiap kolom data terdiri dari columnKey dan columnValue dalam format columnKey=columnValue. Nilai columnValue bisa bertipe integer atau floating-point. Jika Anda menambahkan i di akhir nilai, tipe data dari nilai tersebut adalah integer. Sebaliknya, tipe data dari nilai tersebut adalah floating-point.
timestamp	Ya	1609459200000000000	Waktu saat baris data deret waktu dihasilkan. Nilai parameter ini adalah timestamp. Unit: nanodetik (ns). null Setelah data diimpor ke tabel deret waktu, timestamp dalam nanodetik dalam file konfigurasi secara otomatis dikonversi menjadi timestamp dalam mikrodetik.

Contoh

Impor data deret waktu dari file import_timeseries.txt ke tabel deret waktu.

import_timeseries --input /temp/import_timeseries.txt

Tanyakan data deret waktu

Tanyakan data deret waktu dalam rentang waktu tertentu.

Sintaksis Perintah

getts --k '["measurement_name","data_source",["tagKey1=tagValue1","tagKey2=tagValue2"]]' --time_start 0 --time_end 1635162900000000 --limit 100

Tabel berikut menjelaskan parameter dalam perintah.

Parameter	Diperlukan	Contoh	Deskripsi
--k	Ya	'["cpu","localhost",["region=hangzhou","os=ubuntu"]]'	Pengidentifikasi deret waktu. Nilai parameter ini adalah array yang berisi konten berikut: Nama pengukuran: nama metrik. Dalam contoh ini, nama metrik adalah cpu. Sumber data: sumber data dari mana data dihasilkan. Dalam contoh ini, sumber data adalah localhost. Tag: tag. Nilainya adalah array di mana setiap tag terdiri dari tagKey dan tagValue dalam format tagKey=tagValue.
--time_start	Ya	0	Awal rentang waktu untuk ditanyakan.
--time_end	Ya	1667638230000000	Akhir rentang waktu untuk ditanyakan.
--limit	Tidak	100	Jumlah maksimum baris yang akan dikembalikan. Nilai valid: 1 hingga 5000. Jumlah baris yang sebenarnya dikembalikan ditentukan oleh server.

Contoh

Tanyakan semua data deret waktu yang dihasilkan sebelum 1667638230000000 dalam deret waktu dengan nama metrik cpu, sumber data localhost, dan tag "region=hangzhou" dan "os=ubuntu".

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

Ambil deret waktu

Ambil deret waktu yang memenuhi kondisi tertentu.

Sintaksis Perintah

null

Anda dapat mempersingkat query_ts_meta dalam perintah sebagai qtm.

query_ts_meta --measurement measurement_name --datasource data_source --limit 10

Tabel berikut menjelaskan parameter dalam perintah.

Parameter	Diperlukan	Contoh	Deskripsi
--measurement	Tidak	cpu	Nama metrik.
--datasource	Tidak	localhost	Sumber data.
--limit	Tidak	100	Jumlah maksimum baris yang akan dikembalikan. Nilai valid: 1 hingga 1000. Jumlah baris yang sebenarnya dikembalikan ditentukan oleh server.
-e, --edit	Tidak	{"measurement":"cpu","data_source":"localhost"}	Kondisi kueri dalam format JSON.

Anda juga dapat menjalankan perintah qtm -e dan menentukan kondisi kueri untuk melakukan kueri kompleks. Contoh berikut menunjukkan kondisi kueri:

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

Contoh

Ambil deret waktu dengan nama metrik cpu dan sumber data localhost.

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

Pindai deret waktu

Peroleh semua deret waktu atau sejumlah deret waktu tertentu dalam tabel deret waktu.

Sintaksis Perintah

null

Anda dapat mempersingkat query_ts_meta dalam perintah sebagai qtm.

query_ts_meta --limit limit

Tabel berikut menjelaskan parameter dalam perintah.

Parameter	Diperlukan	Contoh	Deskripsi
--limit	Tidak	10	Jumlah maksimum baris yang akan dikembalikan untuk pemindaian ini. Jika Anda tidak mengonfigurasi parameter ini, semua data dalam tabel dipindai.

Contoh

query_ts_meta --limit 10

Perbarui deret waktu

Ubah properti deret waktu. Jika metadata deret waktu yang ingin diperbarui tidak ada, metadata tersebut akan ditambahkan.

Sintaksis Perintah

null

Anda dapat mempersingkat update_ts_meta dalam perintah sebagai utm.

update_ts_meta --k '["measurement_name","data_source",["tag1=value1","tag2=value2"]]' --attrs '["key1=value1","key2=value2"]'

Tabel berikut menjelaskan parameter dalam perintah.

Parameter

Diperlukan

Contoh

Deskripsi

--k

'["cpu","localhost",["region=hangzhou","os=ubuntu"]]'

Pengidentifikasi deret waktu. Nilai parameter ini adalah array yang berisi konten berikut:

Nama pengukuran: nama metrik. Dalam contoh ini, nama metrik adalah cpu.
Sumber data: sumber data dari mana data dihasilkan. Dalam contoh ini, sumber data adalah localhost.
Tag: tag. Nilainya adalah array di mana setiap tag terdiri dari tagKey dan tagValue dalam format tagKey=tagValue.

--attrs

Tidak

'["city=nanjing","region=jiangning"]'

Properti deret waktu. Nilainya adalah array di mana setiap tag terdiri dari key dan value dalam format key=value.

Contoh

Ubah properti deret waktu yang ditentukan menjadi "city=nanjing" dan "region=jiangning".

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