通過命令列工具使用寬表模型 - Tablestore

Tablestore提供了管理主控台、命令列工具（Tablestore CLI）和Tablestore SDK三種訪問方式。通過命令列工具，您可以使用簡單的命令體驗Tablestore服務。本文介紹如何通過Tablestore CLI管理寬表模型（WideColumn）。

步驟一：下載並啟動命令列工具

根據所用平台下載命令列工具。
平台下載地址
Windows Windows10
Linux
Linux（AMD64）
Linux（ARM64）
macOS macOS

平台	下載地址
Windows	Windows10
Linux	Linux（AMD64） Linux（ARM64）
macOS	macOS

解壓縮下載的工具包，進入命令列工具根目錄後，根據所用平台選擇相應方式啟動命令列工具。

對於Windows平台，雙擊ts.exe檔案。
對於Linux和Mac平台，執行./ts命令。
说明如果在Linux系統或者Mac系統下無可執行許可權，請執行chmod 755 ts命令賦權後再啟動命令列工具。

啟動介面如下所示。

# Welcome to use Command Line Tool for Aliyun Tablestore. Current Version is '2021-11-11'.
#    _______      _      _              _
#   |__   __|    | |    | |            | |
#      | |  __ _ | |__  | |  ___   ___ | |_   ___  _ __    ___
#      | | / _' || '_ \ | | / _ \ / __|| __| / _ \ | '__| / _ \
#      | || (_| || |_) || ||  __/ \__ \| |_ | (_) || |   |  __/
#      |_| \__,_||_.__/ |_| \___| |___/ \__| \___/ |_|    \___|
#
# Please visit our product website: https://www.aliyun.com/product/ots
# You can also join our DingTalk Chat Group (ID: 11789671 or 23307953) to discuss and ask Tablestore related questions.
#
tablestore>

步驟二：開通Tablestore服務

如果已經開通Tablestore服務，請跳過此操作。服務僅需開通一次，開通過程免費。

通過config命令配置AccessKey資訊。
重要此處必須使用阿里雲帳號的AccessKey（包括AccessKey ID和AccessKey Secret）。關於擷取AccessKey的具體操作，請參見擷取AccessKey。
```
config --id NTSVLeBHzgX2i************ --key 7NR2DiotscDbauohSq9kSHX8BDp9****************
```
執行enable_service命令，開通Tablestore服務。

步驟三：建立執行個體

通過create_instance命令建立一個高效能執行個體。

執行以下命令，在華東1（杭州）地區建立myinstance執行個體，執行個體類型為高效能執行個體。

create_instance -d "First instance created by CLI." -n myinstance -r cn-hangzhou

步驟四：配置接入資訊

通過config命令配置接入資訊。

執行以下命令，使用已建立的myinstance執行個體配置接入資訊。

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

步驟五：建立並使用資料表

建立資料表後，選擇要進行操作的資料表，用於後續表操作或者資料操作。

執行如下命令，建立order資料表。

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

執行如下命令，使用order資料表。
```
use --wc -t order
```

步驟六：資料操作

根據需要進行資料操作，您可以插入一行資料、更新一行資料、讀取一行資料、刪除一行資料、匯入資料或者匯出資料。

插入一行資料

在資料表中插入一行資料。

put --pk '["000000114d884ca1dbd6b9a58e8d0d94"]' --attr '[{"c":"pBrand","v":"brand1"},{"c":"pPrice","v":1599.0},{"c":"payTime","v":1509615334404,"isint":true},{"c":"totalPrice","v":2498.99},{"c":"sName","v":"售周五"},{"c":"pId","v":"p0003004"},{"c":"oId","v":"o0039248410"},{"c":"hasPaid","v":true},{"c":"sId","v":"s0015"},{"c":"orderTime","v":1509614885965,"isint":true},{"c":"pName","v":"brand1 type"},{"c":"cName","v":"消馮八"},{"c":"pType","v":"手機"},{"c":"pCount","v":1,"isint":true},{"c":"cId","v":"c0018"}]'

更新一行資料

更新主鍵列為“000000114d884ca1dbd6b9a58e8d0d94”的行資料。無論此行是否存在均會插入新資料，如果之前行已存在，則寫入資料時會覆蓋原有資料。

update --pk '["000000114d884ca1dbd6b9a58e8d0d94"]' --attr '[{"c":"pBrand","v":"brand2"},{"c":"pPrice","v":1599.0},{"c":"payTime","v":1509615334404,"isint":true},{"c":"totalPrice","v":2498.99},{"c":"sName","v":"售周五"},{"c":"pId","v":"p0003004"},{"c":"oId","v":"o0039248410"},{"c":"hasPaid","v":true},{"c":"sId","v":"s0015"},{"c":"orderTime","v":1509614885965,"isint":true},{"c":"pName","v":"brand2 type"},{"c":"cName","v":"消馮八"},{"c":"pType","v":"手機"},{"c":"pCount","v":1,"isint":true},{"c":"cId","v":"c0018"}]'  --condition ignore

讀取一行資料

讀取主鍵列值為“000000114d884ca1dbd6b9a58e8d0d94”的行資料。

get --pk '["000000114d884ca1dbd6b9a58e8d0d94"]'

輸出結果如下所示。

+----------------------------------+-------+--------+---------+-------------+---------------+--------+--------+----------+-------------+--------+-------+---------------+-------+--------+------------+
| id                               | cId   | cName  | hasPaid | oId         | orderTime     | pBrand | pCount | pId      | pName       | pPrice | pType | payTime       | sId   | sName  | totalPrice |
+----------------------------------+-------+--------+---------+-------------+---------------+--------+--------+----------+-------------+--------+-------+---------------+-------+--------+------------+
| 000000114d884ca1dbd6b9a58e8d0d94 | c0018 | 消馮八 | true    | o0039248410 | 1509614885965 | brand1 | 1      | p0003004 | brand1 type | 1599   | 手機  | 1509615334404 | s0015 | 售周五 | 2498.99    |
+----------------------------------+-------+--------+---------+-------------+---------------+--------+--------+----------+-------------+--------+-------+---------------+-------+--------+------------+

匯入資料
下載範例資料壓縮包到本地並解壓，然後執行import命令大量匯入資料。
说明範例資料中總共包含100萬條訂單資料，可通過import -l參數自訂匯入行數。
匯入範例資料檔案中的5萬條訂單資料到當前表，且使用目前時間作為時間戳記。其中yourFilePath表示範例資料壓縮包解壓後的路徑，例如D:\\order_demo_data_1000000\\order_demo_data_1000000。
```
import -i yourFilePath --ignore_version -l 50000
```
輸出結果如下所示。
```
Current speed is: 15800 rows/s. Total succeed count 15800, failed count 0.
Current speed is: 27400 rows/s. Total succeed count 43200, failed count 0.
Import finished, total count is 50000, failed 0 rows.
```
掃描資料
掃描擷取資料表中的最多10行資料。
```
scan --limit 10
```
刪除一行資料
刪除主鍵列值為“000000114d884ca1dbd6b9a58e8d0d94”的行資料。
```
delete --pk '["000000114d884ca1dbd6b9a58e8d0d94"]'
```
匯出資料
匯出當前表中全部資料到本地檔案mydata.json。
```
scan -o /tmp/mydata.json
```
匯出當前表中pId、oId和cName列的資料到本地檔案mydata.json。
```
scan -o /tmp/mydata.json -c pId,oId,cName
```

步驟七：使用SQL查詢資料

SQL查詢相容MySQL的查詢文法，同時提供基礎的SQL DDL建表能力。對於已有資料表，通過執行CREATE TABLE一鍵自動建立映射關係後，您可以使用SQL方式訪問表中資料。

如果要使用SQL語句快速查詢表中資料，請執行以下步驟：

執行sql命令，進入SQL模式。

執行以下命令，為order資料表綁定映射關係。

说明資料表與映射表的欄位類型對應關係請參見資料類型映射。

CREATE TABLE `order` (
    `id` VARCHAR(1024),
    `cId` MEDIUMTEXT,
    `cName` MEDIUMTEXT,
    `hasPaid` BOOL,
    `oId` MEDIUMTEXT,
    `orderTime` BIGINT(20),
    `pBrand` MEDIUMTEXT,
    `pCount` BIGINT(20),
    `pId` MEDIUMTEXT,
    `pName` MEDIUMTEXT,
    `pPrice` DOUBLE,
    `pType` MEDIUMTEXT,
    `payTime` BIGINT(20),
    `sId` MEDIUMTEXT,
    `sName` MEDIUMTEXT,
    `totalPrice` DOUBLE,
    PRIMARY KEY(`id`)
);

根據需要查詢order表中的資料。
- 樣本一：查詢10條售貨員姓名為“售周五”的訂單，按照訂單總金額升序排列。
```
SELECT * FROM `order` WHERE sName = "售周五" ORDER BY totalPrice ASC LIMIT 10;
```
- 樣本二：統計產品類型為“手機”的訂單條數。
```
SELECT count(*) FROM `order` WHERE pType = "手機";
```
- 樣本三：統計產品個數大於1的訂單條數。
```
SELECT count(*) FROM `order` WHERE pCount > 1;
```

如果要退出SQL模式，請執行exit;命令。