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 で 「Apple では悪意のあるソフトウェアがないか確認できないため、"ts" を開くことができません」 というメッセージが表示された場合は、[プライバシーとセキュリティ] 設定に移動して 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
```

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

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"]]'

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

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

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