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