时序表操作

更新时间:
复制 MD 格式

通过命令行工具创建、列出、使用、查看、更新和删除时序模型

前提条件

  • 已完成命令行工具的安装和访问凭证配置。具体操作,请参见命令行工具

  • 已创建实例。具体操作,请参见实例操作

创建时序表

create -m timeseries -t <tableName> --ttl <timeToLive>

参数

必填

说明

-m, --model

表类型。创建时序表时设置为 timeseries。

-t, --table

时序表名称。

--ttl

时序表的数据存活时间,单位为秒。默认值为 -1,表示数据永不过期。取值为大于等于 86400 秒(一天)或 -1(永不过期)。

重要

系统以用户传入的时间列判断数据产生时间,并非数据写入表中的时间。

示例

创建名称为 mytable 的时序表,数据永不过期。

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

列出时序表

列出当前实例下的所有时序表名称。

list_table --ts

使用时序表

选择目标时序表,后续数据操作在该表上执行。

use --ts -t <tableName>

参数

必填

说明

--ts

指定操作对象为时序表。

-t, --table

时序表名称。

示例

use --ts -t mytable

查看时序表信息

desc --ts -t <tableName>

参数

必填

说明

--ts

表示操作的表为时序表。已通过use --ts选定时序表时可省略。

-t, --table

时序表名称。已通过use选定时序表时可省略。

-f, --print_format

输出格式。取值为 json(默认)或 table

-o, --output

将表信息输出为本地 JSON 文件。

示例

desc --ts -t mytable

更新时序表

更新时序表的数据存活时间。

alter --ttl <timeToLive> --ts

参数

必填

说明

--ts

指定操作对象为时序表。

--ttl

时序表的数据存活时间,单位为秒。取值为大于等于 86400 秒(一天)或 -1(永不过期)。

重要

系统以用户传入的时间列判断数据产生时间,并非数据写入表中的时间。

示例

修改当前时序表的数据存活时间为 86400 秒(即 1 天)。

alter --ttl 86400 --ts

删除时序表

drop -t <tableName> --ts -y

参数

必填

说明

-t, --table

时序表名称。

--ts

指定操作对象为时序表。

-y, --yes

跳过删除确认提示。

示例

删除 mytable 时序表。

drop -t mytable --ts -y