使用命令行工具对时序表进行增删改查操作 - 表格存储

本文介绍如何使用命令行工具对时序表进行操作，您可以通过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	否	不涉及	列出时序表名称。