使用命令列工具對時序表進行增刪改查操作 - Tablestore

本文介紹如何使用命令列工具對時序表進行操作，您可以通過Tablestore CLI建立表、使用表、更新表、查看錶資訊、刪除表以及列出表名稱。

說明

關於時序模型的更多資訊，請參見時序模型概述。

建立表

建立一張時序表，同時指定時序表的資料生命週期（TimeToLive）。

命令格式

create -m mode -t tableName --ttl timeToLive

配置項說明請參見下表。

配置項	是否必填	樣本值	說明
-m，--model	是	timeseries	建立的表類型。取值範圍如下： widecolumn（預設）：資料表。 timeseries：時序表。
-t，--table	是	mytable	時序表名稱。
--ttl	否	864000	時序表的資料存活時間。預設值為-1，表示資料永不到期。單位為秒。當系統判斷目前時間減去使用者傳入資料列的時間已經超過設定的資料生命週期時，系統會自動清理超過資料生命週期的資料。重要在時序表中，系統判斷資料產生時間以使用者傳入的時間列為準，並非資料寫入表中的時間。取值：大於等於86400秒（一天）或-1（資料永不到期）。

樣本

建立名稱為mytable的時序表，表中資料永不到期。

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

使用表

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

命令格式

use --ts -t tableName

配置項說明請參見下表。

配置項	是否必填	樣本值	說明
--ts	是	不涉及	表示操作的表為時序表。
-t，--table	是	mytable	時序表名稱。

樣本

使用mytable時序表。

use --ts -t mytable

更新表

更新時序表的資料生命週期。

命令格式

alter --ttl timeToLive --ts

配置項說明請參見下表。

配置項

是否必填

樣本值

說明

--ts

是

不涉及

表示操作的表為時序表。

--ttl

是

864000

時序表的資料存活時間。預設值為-1，表示資料永不到期。單位為秒。

當系統判斷目前時間減去使用者傳入資料列的時間已經超過設定的資料生命週期時，系統會自動清理超過資料生命週期的資料。

重要

在時序表中，系統判斷資料產生時間以使用者傳入的時間列為準，並非資料寫入表中的時間。

取值：大於等於86400秒（一天）或-1（資料永不到期）。

樣本

修改當前表的資料生命週期為86400秒（即1天）。

alter --ttl 86400 --ts

查看錶資訊

查看時序表的資訊。

命令格式

desc --ts -t tableName

配置項說明請參見下表。

配置項	是否必填	樣本值	說明
--ts	否	不涉及	表示操作的表為時序表。
-t，--table	否	mytable	時序表名稱，可不配置。
-f，--print_format	否	json	表資訊的輸出格式。取值範圍為json（預設）和table。
-o，--output	否	/tmp/describe_table_meta.json	輸出表資訊到本地JSON格式的檔案中。

樣本

查看當前表的資訊。

desc

查看mytable時序表的資訊。

desc --ts -t mytable

刪除表

刪除不需要的表。

命令格式

drop -t tableName --ts -y

配置項說明請參見下表。

配置項	是否必填	樣本值	說明
-t，--table	是	mytable	時序表名稱。
-y，--yes	是	不涉及	顯示確認資訊。命令中必須帶有此配置項。
--ts	是	不涉及	表示操作的表為時序表。

樣本

刪除mytable表。

drop -t mytable --ts -y

列出表名稱

列出執行個體下的所有表名稱、所有資料表名稱或者所有時序表名稱。

列出與當前表類型相同的所有表名稱
```
list
```
列出所有表名稱
```
list -a
```
列出所有資料表名稱
```
list -w
```
列出所有時序表名稱
```
list -t
```

配置項說明請參見下表。

配置項	是否必填	樣本值	說明
-a，--all	否	不涉及	列出所有表名稱。
-d，--detail	否	不涉及	列出表的詳細資料。
-w，--wc	否	不涉及	列出所有資料表名稱。
-t，--ts	否	不涉及	列出時序表名稱。