本文介紹如何使用命令行工具對時序表進行操作,您可以通過Tablestore CLI創建表、使用表、更新表、查看表信息、刪除表以及列出表名稱。
關于時序模型的更多信息,請參見時序模型概述。
創建表
創建一張時序表,同時指定時序表的數據生命周期(TimeToLive)。
命令格式
create -m mode -t tableName --ttl timeToLive
配置項說明請參見下表。
配置項 | 是否必填 | 示例值 | 說明 |
-m,--model | 是 | 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 | 否 | 不涉及 | 列出時序表名稱。 |