时序模型快速入门

时序模型是针对时间序列数据的特点进行设计，适用于物联网设备监控、设备采集数据、机器监控数据等场景，能提供高并发写入和查询以及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****************************************

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

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

执行以下命令，创建mytable时序表。
```
create -m timeseries -t mytable --ttl -1
```
执行如下命令，使用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"]'