Tablestore CLI をダウンロードした後、CLI を起動し、AccessKey ペアやインスタンス情報など、Tablestore に関するアクセス情報を構成する必要があります。
前提条件
Tablestore CLI パッケージがダウンロードされていること。詳細については、「Tablestore CLI をダウンロードする」をご参照ください。
AccessKey ペアを取得していること。Tablestore を使用するには、Tablestore CLI で Alibaba Cloud アカウントの AccessKey ペアを構成する必要があります。詳細については、「AccessKey ペアを作成する」をご参照ください。
重要Tablestore をアクティブ化するには、Alibaba Cloud アカウントを使用する必要があります。セキュリティ上の理由から、RAM ユーザーとして Tablestore の機能を使用することをお勧めします。 RAM ユーザーを作成し、AliyunOTSFullAccess ポリシーを RAM ユーザーにアタッチして Tablestore を管理する権限を RAM ユーザーに付与し、RAM ユーザーの AccessKey ペアを作成できます。詳細については、「RAM ユーザーの作成」、「RAM ユーザーへの権限付与」、および「AccessKey ペアを作成する」をご参照ください。
手順
ダウンロードした Tablestore CLI パッケージを解凍します。パッケージのルートディレクトリに移動し、オペレーティングシステムに基づいて Tablestore CLI を起動するために使用されるメソッドを選択します。
Windows の場合、ts.exe ファイルをダブルクリックします。
Linux および macOS の場合、
./tsコマンドを実行します。
説明Linux または macOS でコマンドを実行するために必要な権限がない場合は、
chmod 755 tsコマンドを実行して権限を取得してから、Tablestore CLI を起動するコマンドを実行します。macOS で
"ts" cannot be opened because Apple cannot check it for malicious softwareというメッセージが表示された場合は、macOS の [プライバシーとセキュリティ] 設定でtsコマンドの実行を許可する必要があります。起動時に次の情報が表示されます。
# Welcome to use Command Line Tool for Aliyun Tablestore. Current Version is '2021-11-11'. # _______ _ _ _ # |__ __| | | | | | | # | | __ _ | |__ | | ___ ___ | |_ ___ _ __ ___ # | | / _' || '_ \ | | / _ \ / __|| __| / _ \ | '__| / _ \ # | || (_| || |_) || || __/ \__ \| |_ | (_) || | | __/ # |_| \__,_||_.__/ |_| \___| |___/ \__| \___/ |_| \___| # # Please visit our product website: https://www.aliyun.com/product/ots # You can also join our DingTalk Chat Group (ID: 11789671 or 23307953) to discuss and ask Tablestore related questions. # tablestore>
アクセス情報を構成します。
インスタンス情報やアクセス認証情報などのアクセス情報を、後続の操作の基礎として Tablestore CLI に構成します。アクセス情報を構成する際に、Tablestore にリクエストは送信されません。そのため、アクセス情報は検証されません。
Tablestore をアクティブ化していない場合、またはインスタンスを作成していない場合は、AccessKey ペアのみを構成する必要があります。
次のサンプルコードは、構成の例を示しています。
config --id NTS********************** --key 7NR2****************************************Tablestore をアクティブ化している場合、またはインスタンスを作成している場合は、AccessKey ペアを構成する際に、アクセスするインスタンスに関する情報を構成できます。
次のサンプルコードは、構成の例を示しています。
config --endpoint https://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance --id NTS********************** --key 7NR2****************************************一時的な承認に基づいて Tablestore にアクセスする場合は、セキュリティトークンサービス ( STS ) から一時的なアクセス認証情報を取得し、一時的なアクセス認証情報を使用してアクセス情報を構成できます。次のサンプルコードは、構成の例を示しています。
config --endpoint https://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance --id NTS********************** --key 7NR2**************************************** --token STS.6MC2****************************************次の表は、設定項目について説明しています。
設定項目
必須
例
説明
--endpoint
いいえ
https://myinstance.cn-hangzhou.ots.aliyuncs.com
Tablestore インスタンスにアクセスするために使用するエンドポイント。詳細については、「エンドポイント」をご参照ください。既存のインスタンスにアクセスする場合は、この設定項目を指定する必要があります。
--instance
いいえ
myinstance
アクセスする Tablestore インスタンスの名前。既存のインスタンスにアクセスする場合は、この設定項目を指定する必要があります。
--id
はい
NTS**********************
Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ID と AccessKey シークレット。
説明STS から取得した一時的なアクセス認証情報を使用して Tablestore にアクセスする場合は、この設定項目を STS から返された一時的な AccessKey ID と AccessKey シークレットに設定します。
--key
はい
7NR2****************************************
--token
いいえ
STS.6MC2****************************************
一時的なセキュリティトークン。 STS から取得した一時的なアクセス認証情報を使用して Tablestore にアクセスする場合は、この設定項目を指定する必要があります。
--token ""を指定して、設定項目を空にすることができます。
関連情報
RAM ユーザー、および RAM ユーザーを使用して企業の ID と権限を管理する方法については、「RAM ユーザーとは」をご参照ください。
Tablestore をアクティブ化する方法については、「Tablestore のアクティブ化」をご参照ください。
Tablestore インスタンスを作成する方法については、「インスタンス操作」をご参照ください。
Tablestore インスタンスを作成し、Tablestore CLI でアクセスするインスタンスに関する情報を構成すると、アプリケーションに必要なデータストレージモデルに基づいて Tablestore 機能を使用できます。
データストレージモデル
操作
Wide Column モデル
データテーブルを作成し、テーブルに対して操作を実行します。詳細については、「データテーブルの操作」をご参照ください。
インデックスを使用してデータクエリを高速化します。詳細については、「セカンダリインデックス」および「検索インデックス」をご参照ください。
SQL 文を実行してデータをクエリします。詳細については、「SQL クエリ」をご参照ください。
データを移行する場合、またはコンピュートエンジンを使用してデータを処理する場合は、トンネルサービスを使用します。詳細については、「トンネルサービス」をご参照ください。
TimeSeries モデル
時系列テーブルを作成し、テーブルに対して操作を実行します。詳細については、「時系列テーブルの操作」をご参照ください。
SQL 文を実行してデータをクエリします。詳細については、「SQL クエリ」をご参照ください。