すべてのプロダクト
Search
ドキュメントセンター

Tablestore:Tablestore CLI

最終更新日:Jul 10, 2026

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

クイックスタート

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

CLI ツールのダウンロード

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

プラットフォーム

ダウンロードリンク

Windows

Linux

macOS

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 ツールを使用してサービスを有効化し、インスタンスを作成することもできます。

基本的な操作

基本的なデータ操作を実行して、接続を確認してください。

ワイドカラム

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

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

    create -t order --pk '[{"c":"id","t":"string"}]'
  2. データテーブルに切り替えます。

    use --wc -t order
  3. 1 行のデータを書き込みます。

    put --pk '["id001"]' --attr '[{"c":"name","v":"test"},{"c":"age","v":20}]'
  4. その行を読み取ります。

    get --pk '["id001"]'

詳細については、「Wide Column モデル」をご参照ください。

時系列

サーバー監視用の時系列テーブルを作成し、データをクエリして、時系列の基本的な操作を確認してください。

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

  1. 時系列テーブルを作成します。

    create -t mytable --ttl -1 -m timeseries
  2. 時系列テーブルに切り替えます。

    use --ts -t mytable
  3. 時系列データを書き込みます。

    putts --k '["cpu","host001",["region=hangzhou","os=linux"]]' --field '[{"c":"cpu_usage","v":0.65},{"c":"load","v":2.1}]'
  4. 時系列データをクエリします。

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

詳細については、「TimeSeries モデル」をご参照ください。

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

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