Tablestore CLI で時系列モデルを使用する - Tablestore - Alibaba Cloud ドキュメントセンター

時系列モデルは、時系列データの特性に基づいて設計されています。このモデルは、IoT デバイスの監視などのシナリオに適しており、デバイスによって収集されたデータやマシンのモニタリングデータを格納するために使用できます。時系列モデルを使用すると、アプリケーションは高い同時実行性でデータの書き込みと読み取りを実行でき、ペタバイト規模のデータを低コストで保存できます。このトピックでは、Tablestore CLI を使用して時系列モデルを使い始める方法について説明します。

前提条件

インスタンスが作成されていること。詳細については、「インスタンスの作成」をご参照ください。

注意事項

時系列モデルは、中国 (杭州)、中国 (上海)、中国 (北京)、中国 (張家口)、中国 (ウランチャブ)、中国 (深セン)、中国 (成都)、中国 (香港)、日本 (東京)、マレーシア (クアラルンプール)、ドイツ (フランクフルト)、インドネシア (ジャカルタ)、英国 (ロンドン)、米国 (シリコンバレー)、米国 (バージニア)、SAU (リヤド - パートナーリージョン)、およびシンガポールの各リージョンでサポートされています。

手順

ステップ 1：アクセスするインスタンスの情報を構成する

config コマンドを実行してアクセス情報を構成します。

コマンドを実行する前に、コマンド内のエンドポイント、インスタンス名、AccessKey ID、および AccessKey シークレットを実際のエンドポイント、インスタンス名、AccessKey ID、および AccessKey シークレットに置き換えてください。

config --endpoint https://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance --id NTSVL******************** --key 7NR2****************************************

ステップ 2：時系列テーブルを作成して使用する

時系列テーブルを作成した後、時系列テーブルを選択して、後続のテーブル操作またはデータ操作を時系列テーブルで実行できます。

次のコマンドを実行して、mytable という名前の時系列テーブルを作成します。
```
create -m timeseries -t mytable --ttl -1
```
次のコマンドを実行して、mytable という名前の時系列テーブルを使用します。
```
use --ts -t mytable
```

ステップ 3：データ操作を実行する

ビジネス要件に基づいて、時系列データの書き込みとクエリ、および時系列メタデータの管理を実行できます。

時系列データの書き込み

時系列データの行を挿入します。

次のサンプルコマンドは、時系列テーブルに行の時系列データを挿入する方法を示しています。

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 1737451312000000

時系列データをインポートします。
次のサンプルコマンドは、import_timeseries.txt ファイルから時系列テーブルに時系列データをインポートする方法を示しています。
```
import_timeseries --input /temp/import_timeseries.txt
```
import_timeseries.txt ファイルのサンプル構成：
```
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
```

時系列データのクエリ

次のサンプルコマンドは、メトリック名が cpu、データソースが host_0、タグが hostname=host_0 および region=cn-hangzhou である時系列で、1667638230000000 より前に生成された時系列データをクエリする方法を示しています。

テーブル内の時系列データをクエリするために SQL 文を実行できます。詳細については、「SQL クエリ」をご参照ください。

getts --k '["cpu","host_0",["hostname=host_0","region=cn-hangzhou"]]' --time_start 0 --time_end 1667638230000000 --limit 100

時系列メタデータの管理

時系列を取得します。
次のサンプルコマンドは、メトリック名が cpu、データソースが host_0 である時系列を取得する方法を示しています。
```
query_ts_meta --measurement cpu --datasource host_0 --limit 10
```
時系列をスキャンします。
次のサンプルコマンドは、時系列テーブルで最大 10 個の時系列を取得する方法を示しています。
```
query_ts_meta --limit 10
```
時系列を更新します。
次のサンプルコマンドは、時系列のプロパティを hostname=host_1 および region=cn-hangzhou に更新する方法を示しています。
```
update_ts_meta --k '["cpu","host_1",["hostname=host_1","region=cn-hangzhou"]]' --attrs '["hostname=host_1","region=cn-hangzhou"]' 
```