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

Tablestore CLI を使用して、開発、デバッグ、運用のためにワイドカラムデータと時系列データを管理します。

クイックスタート

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

CLI ツールのダウンロード

CLI ツールは、Windows、Linux、macOS に対応しています。

プラットフォーム	ダウンロードリンク
Windows	aliyun-tablestore-cli-windows-amd64-a0a4086.zip
Linux	aliyun-tablestore-cli-linux-amd64-a0a4086.zip aliyun-tablestore-cli-linux-arm64-a0a4086.zip
macOS	aliyun-tablestore-cli-darwin-amd64-a0a4086.zip aliyun-tablestore-cli-darwin-arm64-a0a4086.zip

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 -t mytable --ttl -1 -m timeseries
```
時系列テーブルに切り替えます。
```
use --ts -t mytable
```

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

putts --k '["cpu","host001",["region=hangzhou","os=linux"]]' --field '[{"c":"cpu_usage","v":0.65},{"c":"load","v":2.1}]'

時系列データをクエリします。

getts --k '["cpu","host001",["region=hangzhou","os=linux"]]'

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

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

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