Tablestore：通過命令列工具使用

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

1. 根據所用平台下載命令列工具。

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

2. 解壓縮下載的工具包，進入命令列工具根目錄後，根據所用平台選擇相應方式啟動命令列工具。
   • 對於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服務，請跳過此操作。服務僅需開通一次，開通過程免費。

1. 通過config命令配置AccessKey資訊。
   重要 此處必須使用阿里雲帳號的AccessKey（包括AccessKey ID和AccessKey Secret）。關於擷取AccessKey的具體操作，請參見擷取AccessKey。

   config --id NTSVLeBHzgX2iZfcaXXPJ**** --key 7NR2DiotscDbauohSq9kSHX8BDp99bjs7eNpCR7o****

2. 執行enable_service命令，開通Tablestore服務。

步驟三：建立時序模型執行個體

具體操作，請參見建立時序模型執行個體。

步驟四：配置接入資訊

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

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

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

步驟五：建立並使用時序表

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

1. 執行以下命令，建立mytable時序表。

   create -m timeseries -t mytable --ttl -1

2. 執行use --ts -t mytable命令，使用mytable時序表。

步驟六：資料操作

根據需要進行資料操作，您可以寫入時序資料、匯入時序資料、查詢時序資料、檢索時間軸、掃描時間軸以及更新時間軸。

• 寫入時序資料

  插入一行時序資料。

  putts --k '["cpu","localhost",["region=hangzhou","os=ubuntu"]]' --field '[{"c":"fieldname","v":"fieldvalue"},{"c":"bool_field","v":true},{"c":"double_field","v":1.1},{"c":"int_value","v":10,"isint":true}]' --time 1635162859000000

• 匯入時序資料

  匯入import_timeseries.txt檔案中的時序資料到時序表中。

  import_timeseries --input /temp/import_timeseries.txt

  設定檔的樣本如下：

  cpu,hostname=host_0,region=cn-hangzhou usage_user=58i,usage_system=2i,usage_idle=24i 1609459200000000000
  cpu,hostname=host_1,region=cn-hangzhou usage_user=58i,usage_system=2i,usage_idle=24i 1609459200000000000

• 查詢時序資料

  查詢度量名稱為cpu，資料來源標識為localhost，且標籤為"region=hangzhou"和"os=ubuntu"的時間軸中1667638230000000之前產生的所有時序資料。

  getts --k '["cpu","localhost",["region=hangzhou","os=ubuntu"]]' --time_start 0 --time_end 1667638230000000 --limit 100

• 檢索時序線
  檢索度量名稱為cpu且資料來源標識為localhost的時間軸。

  query_ts_meta --measurement cpu --datasource localhost --limit 10

• 掃描時間軸

  query_ts_meta --limit 10

• 更新時間軸

  更新指定時間軸的屬性為"city=nanjing"和"region=jiangning"。

  update_ts_meta --k '["cpu","localhost",["city=hangzhou","region=xihu"]]' --attrs '["city=nanjing","region=jiangning"]' 

步驟七：使用SQL查詢資料

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

1. 執行sql命令，進入SQL模式。
2. 執行以下命令，查詢mytable表中所有資料。

   SELECT * FROM mytable;

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