时序模型快速入门

时序模型是针对时间序列数据的特点进行设计,适用于物联网设备监控、设备采集数据、机器监控数据等场景,能提供高并发写入和查询以及PB级海量数据的低成本存储。本文介绍如何使用命令行工具使用时序模型。

前提条件

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

注意事项

目前支持时序模型功能的地域包括华东1(杭州)、华东2(上海)、华北2(北京)、华北3(张家口)、华北6(乌兰察布)、华南1(深圳)、西南1(成都)、中国香港、日本(东京)、新加坡、马来西亚(吉隆坡)、印度尼西亚(雅加达)、德国(法兰克福)、英国(伦敦)、美国(硅谷)、美国(弗吉尼亚)。

如果使用过程中遇到问题,请通过钉钉加入用户群44327024(物联网存储 IoTstore 开发者交流群)联系我们。

操作步骤

步骤一:配置接入实例信息

通过config命令配置接入信息。

执行前请使用您的实例Endpoint、实例名称、AccessKey ID、AccessKey Secret替换命令中的endpoint、instance、id、key。
config --endpoint https://myinstance.cn-hangzhou.ots.aliyuncs.com --instance myinstance --id NTSVL******************** --key 7NR2****************************************

步骤二:创建并使用时序表

创建时序表后,选择要进行操作的时序表,以便进行后续表操作或者数据操作。

  1. 执行以下命令,创建mytable时序表。

    create -m timeseries -t mytable --ttl -1
  2. 执行如下命令,使用mytable时序表。

    use --ts -t mytable

步骤三:数据操作

根据需要进行数据操作,您可以写入时序数据、查询时序数据以及管理时间线元数据。

写入时序数据

  • 插入一行时序数据

    以下示例用于插入一行数据到时序表中。

    putts --k '["cpu","localhost",["region=hangzhou","os=ubuntu"]]' --field '[{"c":"fieldname","v":"fieldvalue"},{"c":"bool_field","v":true},{"c":"double_field","v":1.1},{"c":"int_value","v":10,"isint":true}]' --time 1737451312000000
  • 导入时序数据

    以下示例用于导入import_timeseries.txt文件中的时序数据到时序表中。

    import_timeseries --input /temp/import_timeseries.txt

    import_timeseries.txt文件中的配置示例如下:

    cpu,hostname=host_0,region=cn-hangzhou usage_user=58i,usage_system=2i,usage_idle=24i 1609459200000000000
    cpu,hostname=host_1,region=cn-hangzhou usage_user=58i,usage_system=2i,usage_idle=24i 1609459200000000000

查询时序数据

以下示例用于查询度量名称为cpu,数据源标识为host_0,且标签为"hostname=host_0"和"region=cn-hangzhou"的时间线中1667638230000000之前产生的所有时序数据。

如需使用SQL查询表中数据,请参见SQL查询
getts --k '["cpu","host_0",["hostname=host_0","region=cn-hangzhou"]]' --time_start 0 --time_end 1667638230000000 --limit 100

管理时间线元数据

  • 检索时间线

    以下示例用于检索度量名称为cpu且数据源标识为host_0的时间线。

    query_ts_meta --measurement cpu --datasource host_0 --limit 10
  • 扫描时间线

    以下示例用于获取时序表中最多10个时间线。

    query_ts_meta --limit 10
  • 更新时间线

    以下示例用于更新指定时间线的属性为"hostname=host_1"和"region=cn-hangzhou"。

    update_ts_meta --k '["cpu","host_1",["hostname=host_1","region=cn-hangzhou"]]' --attrs '["hostname=host_1","region=cn-hangzhou"]'