表格存储命令行工具安装与快速入门-表格存储 Tablestore(Tablestore)-阿里云帮助中心

通过命令行工具，可以管理宽表模型和时序模型的数据，适用于开发调试和运维场景。

快速接入

下载命令行工具并配置访问凭证，即可开始操作表格存储资源。

下载命令行工具

命令行工具支持 Windows、Linux 和 macOS 平台。

平台	下载地址
Windows	Windows 10 及之后版本
Linux	Linux（AMD64） Linux（ARM64）
macOS	macOS（AMD64） macOS（ARM64）

启动并配置访问凭证

解压工具包后，进入解压目录启动命令行工具。

Windows

双击 ts.exe 文件。

Linux 和 macOS

执行./ts命令。

说明

如果在 Linux 或 macOS 下无可执行权限，执行chmod 755 ts命令赋权后再启动。
如果 macOS 提示无法打开"ts"，因为Apple无法检查其是否包含恶意软件，需要在隐私与安全性设置中允许运行ts。

启动后，执行 config 命令配置访问凭证：

config --endpoint https://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance --id LTAI******************** --key 7NR2****************************************

参数	说明
`--endpoint`	实例的 Endpoint 地址。
`--instance`	实例名称。
`--id`	AccessKey ID，详见创建AccessKey。
`--key`	AccessKey Secret。
`--token`	（可选）STS 临时访问令牌。通过临时授权访问表格存储时需配置此项。

如果通过 STS 临时授权访问，在 config 命令中追加 --token 参数：

config --endpoint https://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance --id STS.LTAI******************** --key 7NR2**************************************** --token STS.6MC2****************************************

说明

如果还未开通表格存储服务或创建实例，参见开通表格存储服务和创建实例。也可以通过命令行工具完成开通和创建操作。

基本操作

配置完成后，通过基本数据操作验证连接是否正常。

宽表模型

创建数据表并写入、读取数据，验证宽表模型的基本操作。

创建数据表。

create -t order --pk '[{"c":"id","t":"string"}]'

切换到该数据表。
```
use --wc -t order
```

写入一行数据。

put --pk '["id001"]' --attr '[{"c":"name","v":"test"},{"c":"age","v":20}]'

读取该行数据。
```
get --pk '["id001"]'
```

更多宽表模型操作，参见宽表模型。

时序模型

以服务器监控场景为例，创建时序表并写入、查询时序数据。每条数据记录一台主机的 CPU 指标（度量名称为 cpu）。数据源标识主机，标签记录地域和操作系统信息。

创建时序表。
```
create --ts -t mytable --ttl -1
```
切换到该时序表。
```
use --ts -t mytable
```

写入时序数据。

putts --mn cpu --ds host=host001 --tags region=hangzhou,os=linux --fields cpu_usage=0.65,load=2.1

查询时序数据。
```
getts --mn cpu --ds host=host001
```

更多时序模型操作，参见时序模型。

查看命令列表

执行help命令查看所有支持的命令。也可以通过命令关键字 help的形式查看单个命令的选项信息，例如alter help。