インスタンスは、Tablestore でテーブルを管理するために使用される論理エンティティです。各インスタンスはデータベースに相当します。このトピックでは、Tablestore CLI を使用して Tablestore インスタンスを管理する方法について説明します。
前提条件
Tablestore がアクティブ化されていること。詳細については、Tablestore のアクティブ化 を参照してください。
インスタンスの作成
高性能インスタンスを、Tablestore を使用するリージョンに作成します。
インスタンス名はリージョン内で一意である必要があります。指定したインスタンス名が既存のインスタンスと同じであるというエラーが表示された場合は、新しいインスタンス名を指定してください。
Tablestore CLI を使用する場合、高性能インスタンスのみを作成できます。
構文
create_instance -d description -n instanceName -r regionId次の表に、設定項目を示します。
パラメーター | 必須 | 例 | 説明 |
-n | はい | myinstance | インスタンスの名前。詳細については、インスタンス を参照してください。 |
-r | はい | cn-hangzhou | リージョンの ID。詳細については、リージョン を参照してください。 |
-d | いいえ | "First instance created by CLI." | インスタンスの説明。 |
例
次のサンプルコードは、中国 (杭州) リージョンに myinstance という名前の高性能インスタンスを作成する方法の例を示しています。
create_instance -d "First instance created by CLI." -n myinstance -r cn-hangzhouインスタンスの設定
インスタンス内のリソースは、設定後にのみ管理できます。
インスタンス情報がまだ設定されていない場合、または別のインスタンスにアクセスする場合、アクセス情報を設定する際にインスタンスを設定する必要があります。
アクセスするインスタンスを、そのサービスエンドポイントを設定することで指定する必要があります。エンドポイントは、使用しているネットワークの種類によって異なります。
構文
config --endpoint endpoint --instance instanceName次の表に、設定項目を示します。
パラメーター | 必須 | 例 | 説明 |
--endpoint | はい | http://myinstance.cn-hangzhou.ots.aliyuncs.com | インスタンスのエンドポイント。インターネットと仮想プライベートクラウド (VPC) の 2 つのネットワークタイプをサポートしています。ネットワークタイプに基づいてインスタンスのエンドポイントを指定します。エンドポイントの形式は、次のルールに準拠している必要があります。
|
--instance | はい | myinstance | インスタンスの名前。 |
例
次のサンプルコードは、パブリックエンドポイント経由でアクセスされる中国 (杭州) リージョンの myinstance インスタンスを設定する方法を示しています。
config --endpoint http://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance出力例:
{
"Endpoint": "http://myinstance.cn-hangzhou.ots.aliyuncs.com",
"AccessKeyId": "NTS**********************",
"AccessKeySecret": "7NR2****************************************",
"AccessKeySecretToken": "",
"Instance": "myinstance"
}次の表に、パラメーターを示します。
パラメーター | 必須 | 例 | 説明 |
Endpoint | いいえ | https://myinstance.cn-hangzhou.ots.aliyuncs.com | インスタンスのエンドポイント。詳細については、エンドポイント を参照してください。 |
Instance | いいえ | myinstance | インスタンスの名前。 |
AccessKeyId | はい | NTS********************** | Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ID と AccessKey シークレット。 説明 Security Token Service (STS) から取得した一時アクセス認証情報を使用して Tablestore にアクセスする場合、返される AccessKeyId と AccessKeySecret は、それぞれ STS によって返される AccessKey ID と AccessKey シークレットです。 |
AccessKeySecret | はい | 7NR2**************************************** | |
AccessKeySecretToken | いいえ | STS.6MC2**************************************** | 一時アクセストークン。このパラメーターは、STS から取得した一時アクセス認証情報を使用して Tablestore にアクセスする場合に返されます。 |
インスタンス情報の表示
インスタンス名、作成時刻、インスタンスが属するアカウントの ID など、インスタンスに関する情報を照会できます。
構文
describe_instance -r regionId -n instanceName次の表に、設定項目を示します。
パラメーター | 必須 | 例 | 説明 |
-n | はい | myinstance | インスタンスの名前。詳細については、インスタンス を参照してください。 |
-r | はい | cn-hangzhou | リージョンの ID。詳細については、リージョン を参照してください。 |
例
次のサンプルコードは、中国 (杭州) リージョンにある myinstance インスタンスの情報を照会する方法を示しています。
describe_instance -r cn-hangzhou -n myinstance出力例:
{
"ClusterType": "ssd",
"CreateTime": "2024-07-18 09:15:10",
"Description": "First instance created by CLI.",
"InstanceName": "myinstance",
"Network": "NORMAL",
"Quota": {
"EntityQuota": 64
},
"ReadCapacity": 5000,
"Status": 1,
"TagInfos": {},
"UserId": "1379************",
"WriteCapacity": 5000
}インスタンスの照会
指定したリージョン内のすべてのインスタンスを照会できます。
構文
list_instance -r regionId次の表に、設定項目を示します。
パラメーター | 必須 | 例 | 説明 |
-r | はい | cn-hangzhou | リージョンの ID。 |
例
次のサンプルコードは、中国 (杭州) リージョンにあるすべてのインスタンスのリストを取得する方法を示しています。
list_instance -r cn-hangzhou出力例:
指定したリージョンにインスタンスが作成されていない場合、返される結果は空になります。
[
"myinstance"
]関連情報
インスタンスを作成し、インスタンスのアクセス情報を設定した後、ビジネスに必要なデータストレージモデルに基づいて Tablestore の機能を使用できます。
データモデル | 使用プロセス |
ワイドカラムモデル |
データを移行する場合、または計算エンジンを使用してデータを処理する場合は、Tunnel Service を使用します。詳細については、Tunnel Service を参照してください。 |
時系列モデル |
|