執行個體（Instance）是您使用和管理Table Store服務的實體，每個執行個體相當於一個資料庫。本文介紹如何使用Tablestore CLI以命令列的方式管理Tablestore執行個體。
前提條件
已開通Table Store服務。具體操作，請參見開通Table Store服務。
建立執行個體
在指定地區下建立一個高效能執行個體。
執行個體名需要在地區內全域唯一。如果出現執行個體名衝突錯誤，請重新命名。
使用命令列工具只能建立高效能執行個體。
命令格式
create_instance -d description -n instanceName -r regionId配置項說明請參見下表。
配置項 | 是否必填 | 樣本值 | 描述 |
-n | 是 | myinstance | 執行個體名稱。更多資訊，請參見執行個體。 |
-r | 是 | cn-hangzhou | 地區ID。更多資訊，請參見地區。 |
-d | 否 | "First instance created by CLI." | 執行個體描述資訊。 |
樣本
以下樣本用於在華東1（杭州）地區下建立一個高效能執行個體myinstance。
create_instance -d "First instance created by CLI." -n myinstance -r cn-hangzhou配置執行個體
只有配置執行個體後才能操作執行個體下的資源。
在配置接入資訊時，如果未配置執行個體資訊或已配置執行個體但是要修改操作的執行個體，則需要執行配置執行個體操作；如果已配置執行個體且無需修改操作的執行個體，則無需執行配置執行個體操作。
配置執行個體的服務地址用於選擇要操作的執行個體，請根據所處的網路類型來選擇合適的Endpoint進行配置。
命令格式
config --endpoint endpoint --instance instanceName配置項說明請參見下表。
配置項 | 是否必填 | 樣本值 | 描述 |
--endpoint | 是 | http://myinstance.cn-hangzhou.ots.aliyuncs.com | 執行個體的服務地址，支援公網和VPC兩種，請根據實際需要選擇。網域名稱的規則如下：
|
--instance | 是 | myinstance | 執行個體名稱。 |
樣本
以下樣本用於配置華東1（杭州）地區下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********************** | 阿里雲帳號或者RAM使用者的AccessKey ID和AccessKey Secret。 說明 當使用從STS擷取的臨時訪問憑證訪問Table Store時，返回的AccessKeyId和AccessKeySecret分別為臨時訪問憑證的AccessKey ID和AccessKey Secret。 |
AccessKeySecret | 是 | 7NR2**************************************** | |
AccessKeySecretToken | 否 | STS.6MC2**************************************** | 臨時存取權杖。當使用從STS擷取的臨時訪問憑證訪問Table Store時會返回此參數。 |
查看執行個體資訊
查看執行個體的資訊，例如執行個體名稱、建立時間、所屬帳號ID等。
命令格式
describe_instance -r regionId -n instanceName配置項說明請參見下表。
配置項 | 是否必填 | 樣本值 | 描述 |
-n | 是 | myinstance | 執行個體名稱。更多資訊，請參見執行個體。 |
-r | 是 | cn-hangzhou | 地區ID。更多資訊，請參見地區。 |
樣本
以下樣本用於查詢華東1（杭州）地區下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。 |
樣本
以下樣本用於擷取華東1（杭州）地區下所有執行個體列表。
list_instance -r cn-hangzhou返回結果如下：
如果當前地區下未建立執行個體，則返回結果為空白。
[
"myinstance"
]相關文檔
建立執行個體且已配置執行個體的接入資訊後，您可以根據業務所需的資料存放區模型使用Table Store功能。
資料模型 | 使用流程 |
寬表模型 | 如果要遷移資料或者使用計算引擎處理資料，請使用通道服務實現。更多資訊，請參見通道服務。 |
時序模型 |