Tablestore CLI のクイックスタート - Tablestore - Alibaba Cloud ドキュメントセンター

クイックスタート

CLI ツールをダウンロードし、アクセス認証情報を設定して、Tablestore リソースの管理を開始します。

CLI ツールのダウンロード

CLI ツールは、Windows、Linux、macOS をサポートしています。

プラットフォーム	ダウンロードリンク
Windows	Windows 10 以降
Linux	Linux (AMD64) Linux (ARM64)
macOS	macOS (AMD64) macOS (ARM64)

CLI ツールの起動と認証情報の設定

パッケージを解凍し、解凍したディレクトリから CLI ツールを起動します。

Windows

ts.exe ファイルをダブルクリックします。

Linux および macOS

./ts コマンドを実行します。

説明

Linux または macOS でファイルに実行権限がない場合は、ツールを起動する前に chmod 755 ts を実行して権限を付与してください。
macOS で "ts" cannot be opened because Apple cannot check it for malicious software というメッセージが表示された場合は、[プライバシーとセキュリティ] の設定に移動して ts の実行を許可してください。

CLI ツールが起動したら、config コマンドを実行してアクセス認証情報を設定します：

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

パラメーター	説明
`--endpoint`	インスタンスのエンドポイント URL。
`--instance`	インスタンス名。
`--id`	AccessKey ID。詳細については、「AccessKey の作成」をご参照ください。
`--key`	AccessKey Secret。
`--token`	(オプション) STS トークン。このパラメーターは、一時的なアクセス認証情報で Tablestore にアクセスする場合に指定します。

STS の一時的なアクセス認証情報で Tablestore にアクセスするには、config コマンドに --token パラメーターを追加します：

config --endpoint https://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance --id STS.LTAI******************** --key 7NR2**************************************** --token STS.6MC2****************************************

説明

Tablestore を有効化していない場合、またはインスタンスを作成していない場合は、「Tablestore の有効化」および「インスタンスの操作」をご参照ください。 CLI ツールを使用して、サービスを有効化し、インスタンスを作成することもできます。

基本的な操作

基本的なデータ操作を実行して、接続を確認します。

ワイドカラム

データテーブルを作成し、データを書き込み、データを読み取って、基本的なワイドカラム操作を確認します。

データテーブルを作成します。

create -t order --pk '[{"c":"id","t":"string"}]'

ワイドカラムテーブルに切り替えます。
```
use --wc -t order
```

1 行のデータを書き込みます。

put --pk '["id001"]' --attr '[{"c":"name","v":"test"},{"c":"age","v":20}]'

行を読み取ります。
```
get --pk '["id001"]'
```

ワイドカラム操作の詳細については、「Wide Column モデル」をご参照ください。

時系列

サーバーモニタリング用の時系列テーブルを作成し、データをクエリして、基本的な時系列操作を確認します。

以下の手順では、ホストの CPU メトリクス (メジャーメント: cpu) を記録します。データソースはホストを識別し、タグはリージョンとオペレーティングシステムを記録します。

時系列テーブルを作成します。
```
create --ts -t mytable --ttl -1
```
時系列テーブルに切り替えます。
```
use --ts -t mytable
```

時系列データを書き込みます。

putts --mn cpu --ds host=host001 --tags region=hangzhou,os=linux --fields cpu_usage=0.65,load=2.1

時系列データをクエリします。
```
getts --mn cpu --ds host=host001
```

時系列操作の詳細については、「時系列モデル」をご参照ください。

利用可能なコマンドの表示

利用可能なすべてのコマンドを表示するには、help コマンドを実行します。特定のコマンドのオプションを表示するには、<command> help を実行します。たとえば、alter help を実行します。