本文介绍如何使用Tablestore CLI以命令行的方式管理表格存储实例。
开通表格存储服务
如果已经开通表格存储服务,请跳过此操作。服务仅需开通一次,开通过程免费。
命令格式如下,用于开通表格存储服务。
enable_service
返回结果如下:
Your service is enabled.
创建实例
在指定地域下创建一个实例。
注意 实例名需要在地域内全局唯一。如果出现实例名冲突错误,请重新命名。
- 命令格式
create_instance -d description -n instanceName -r regionId
- 示例
在华东1(杭州)地域下创建一个实例myinstance。
create_instance -d "First instance created by CLI." -n myinstance -r cn-hangzhou
查看实例信息
查看实例的信息,例如实例名称、创建时间、所属账号ID等。
- 命令格式
describe_instance -r regionId -n instanceName
- 示例
查询华东1(杭州)地域下myinstance实例的信息。
describe_instance -r cn-hangzhou -n myinstance
返回结果如下:{ "Status": 1, "WriteCapacity": 5000, "ReadCapacity": 5000, "ClusterType": "SSD", "Timestamp": "", "UserId": "643941", "InstanceName": "myinstance", "CreateTime": "2021-10-31 14:19:43", "Network": "NORMAL", "Description": "First instance created by CLI.", "Quota": { "EntityQuota": 64 }, "TagInfos": { "TagInfo": [] } }
获取实例列表
获取指定地域下所有实例的列表。
- 命令格式
list_instance -r regionId
- 示例
获取华东1(杭州)地域下所有实例列表。
list_instance -r cn-hangzhou
配置项说明请参见下表。配置项 是否必填 示例值 描述 -r 是 cn-hangzhou 地域ID。 返回结果如下:说明 如果当前地域下未创建实例,则返回结果为空。[ "myinstance" ]
配置实例
配置实例的服务地址,请根据所处于的网络类型来选择。
- 命令格式
config --endpoint endpoint --instance instanceName
配置项说明请参见下表。配置项 是否必填 示例值 描述 --endpoint 是 http://myinstance.cn-hangzhou.ots.aliyuncs.com 实例的服务地址,支持公网和VPC两种,请根据实际需要选择。域名的规则如下: - 公网:http(s)://<instance_name>.<region_id>.ots.aliyuncs.com
- VPC:http(s)://<instance_name>.<region_id>.vpc.tablestore.aliyuncs.com
--instance 是 myinstance 实例名称。 - 示例
配置华东1(杭州)地域下myinstance实例为公网访问域名。
config --endpoint http://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance
返回结果如下:{ "Endpoint": "http://myinstance.cn-hangzhou.ots.aliyuncs.com", "AccessKeyId": "NTSVLeBHzgX2iZfcaXXPJ****", "AccessKeySecret": "7NR2DiotscDbauohSq9kSHX8BDp99bjs7eNpCR7o****", "Instance": "myinstance" }
返回结果说明请参见下表。配置项 是否必填 示例值 说明 Endpoint 否 https://myinstance.cn-hangzhou.ots.aliyuncs.com 实例的服务地址。更多信息,请参见服务地址。 Instance 否 myinstance 实例名称。 AccessKeyId 是 NTSVLeBHzgX2iZfcaXXPJ**** 阿里云账号或者RAM用户的AccessKey ID和AccessKey Secret。 AccessKeySecret 是 7NR2DiotscDbauohSq9kSHX8BDp99bjs7eNpCR7o****