创建时序表后,您可以使用表、查询表信息、列出表名称、更新表以及删除表。
说明 关于时序模型的更多信息,请参见时序模型概述。
创建表
创建一张时序表,同时指定时序表的数据生命周期(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
列出表名称
列出实例下的所有表名称、所有数据表名称或者所有时序表名称。
- 列出与当前表类型相同的所有表名称
list
- 列出所有表名称
list -a
- 列出所有数据表名称
list -w
- 列出所有时序表名称
list -t
配置项说明请参见下表。
配置项 | 是否必填 | 示例值 | 说明 |
---|---|---|---|
-a,--all | 否 | 不涉及 | 列出所有表名称。 |
-d,--detail | 否 | 不涉及 | 列出表的详细信息。 |
-w,--wc | 否 | 不涉及 | 列出所有数据表名称。 |
-t,--ts | 否 | 不涉及 | 列出时序表名称。 |
更新表
更新时序表的数据生命周期。
- 命令格式
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