命令列工具

通過命令列工具，可以管理寬表模型和時序模型的資料，適用於開發調試和營運情境。

快速接入

下載命令列工具並配置訪問憑證，即可開始動作表格儲存資源。

下載命令列工具

命令列工具支援 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 臨時存取權杖。通過臨時授權訪問Table Store時需配置此項。

如果通過 STS 臨時授權訪問，在 config 命令中追加 --token 參數：

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

說明

如果還未開通Table Store服務或建立執行個體，參見開通服務和執行個體操作。也可以通過命令列工具完成開通和建立操作。

基本操作

配置完成後，通過基本資料操作驗證串連是否正常。

寬表模型

建立資料表並寫入、讀取資料，驗證寬表模型的基本操作。

建立資料表。

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。