コマンドラインインターフェイスによる時系列テーブルのデータ操作 - Tablestore

前提条件

アクセス認証情報が設定済みの CLI。詳細については、「Tablestore CLI」をご参照ください。
時系列テーブル。詳細については、「時系列テーブル操作」をご参照ください。

データの書き込み、インポート、またはクエリを実行する前に、対象の時系列テーブルを選択します。

use --ts -t <tableName>

時系列データの書き込み

指定したタイムラインに 1 行の時系列データを書き込みます。

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

パラメーター	必須	説明
--k	はい	タイムライン識別子は、`["measurement","dataSource",["tag1=value1","tag2=value2"]]` 形式の JSON 配列として表されます。配列には次の要素が含まれます：最初の要素：メジャメント名。 2 番目の要素：データソース識別子。 3 番目の要素：タグ配列。各タグは `tagKey=tagValue` 形式です。
--field	はい	データフィールドは、JSON 配列として表されます。各要素には次のプロパティが含まれます： c (必須)：列名。 v (必須)：列値。サポートされる型：文字列、ブール値、整数、浮動小数点数。 isint (オプション)：値を整数として扱う場合は `true` に設定します。デフォルトは `false` (浮動小数点数) です。
--time	はい	データ行のタイムスタンプ (マイクロ秒 (μs) 単位)。

例

杭州リージョンで監視対象ホストの CPU メトリクスを書き込みます。

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

時系列データのインポート

ローカルファイルから時系列テーブルに時系列データをインポートします。

Windows

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

Linux および macOS

import_timeseries --input /localpath/filename.txt

パラメーター	必須	説明
-i, --input	はい	ローカルデータファイルへのパス。

データファイルの各行は、measurement_name,tags fields timestamp 形式の 1 行の時系列データを表します。

フィールド	必須	説明
measurement_name	はい	メジャメント名。
tags	はい	各タグは `tagKey=tagValue` 形式です。最初のタグの tagValue がデータソース識別子になります。
fields	はい	`fieldKey=fieldValue` 形式のデータフィールド。数値に `i` を追加すると整数を示します。`i` のない値はデフォルトで浮動小数点数になります。
timestamp	はい	ナノ秒 (ns) 単位のタイムスタンプ。インポート後、値は自動的にマイクロ秒に変換されます。

データファイルの例：

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

例

ローカルファイルから時系列データをインポートします。

import_timeseries --input /tmp/import_timeseries.txt

時系列データのクエリ

指定したタイムラインの時間範囲内の時系列データをクエリします。

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

パラメーター	必須	説明
--k	はい	タイムライン識別子。「時系列データの書き込み」セクションの `--k` と同じ形式です。
--time_start	はい	クエリの開始時刻 (マイクロ秒単位のタイムスタンプ)。
--time_end	はい	クエリの終了時刻 (マイクロ秒単位のタイムスタンプ)。
--limit	いいえ	返される最大行数。有効な値：1 ～ 5000。

例

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

タイムラインの検索

指定した条件に一致するタイムラインを検索します。このコマンドの短縮形は qtm です。

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

パラメーター	必須	説明
--measurement	いいえ	メジャメント名。
--datasource	いいえ	データソース識別子。
--limit	いいえ	返される最大行数。有効な値：1 ～ 1000。サーバーは指定された制限よりも少ない行を返す場合があります。
-e, --edit	いいえ	JSON 形式で複雑な検索フィルターを定義します。サポートされるフィルタータイプ： COMPOSITE、MEASUREMENT、SOURCE、TAG。

例

メジャメント名が cpu で、データソース識別子が localhost のタイムラインを検索します。

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

複雑な検索フィルターを定義するには、qtm -e を使用します。フィルターの例：

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

タイムラインのスキャン

時系列テーブルからすべてのタイムライン、または指定した数のタイムラインを取得します。このコマンドの短縮形は qtm です。

query_ts_meta --limit <n>

パラメーター	必須	説明
--limit	いいえ	返される最大行数。指定されていない場合、すべてのタイムラインがスキャンされます。

例

query_ts_meta --limit 10

タイムラインの更新

タイムラインの属性を更新します。対象のタイムラインが存在しない場合、このコマンドはタイムラインを作成します。このコマンドの短縮形は utm です。

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

パラメーター	必須	説明
--k	はい	タイムライン識別子。「時系列データの書き込み」セクションの `--k` と同じ形式です。
--attrs	いいえ	タイムラインの属性は、JSON 配列として表されます。各属性は `key=value` 形式です。

例

監視対象ホストの city 属性と region 属性を設定します。

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