入门指引:数据存储配置和读取


该教程能帮助你学习如何快速配置 TSDB 存储策略及读取存储的数据。

前提条件

  • 已被授权时序数据管理下的存储策略功能
  • 已接入设备并且设备已经在发送数据
  • 已申请时序数据库存储资源

教程目标及数据准备

教程目标

本教程要实现的场景是:将AI类型的原始数据采集点 test_raw 的数据进行分钟级TSDB存储,并通过数据服务Open API获取一段时间内 test_raw 点每五分钟的最大值。


数据准备

模型配置:配置教程请参考 创建模型


本教程使用的模型 test_Model 的配置如下:

功能类型 名称 标识符 测点类型 数据类型
测点 test_raw test_raw AI DOUBLE


登录

EnOS Cloud:登录 EnOS 管理控制台,进入 时序数据管理 > 存储策略 首页。

EnOS Edge:登录 EnOS 管理控制台(无法登陆管理控制台时可使用本地资产配置工具),进入 EnOS Edge > Edge 管理 > Edge 详情 > 时序数据管理 页面。

操作步骤

使用 TSDB 存储策略实现本教程场景的操作步骤如下:

  • 创建存储策略分组
  • 配置 TSDB 存储策略并发布
  • 使用 Open API 获取聚合数据

第一步:配置存储策略分组

EnOS Cloud: 创建存储策略分组

如果尚未创建存储策略分组,可通过以下步骤创建存储策略分组,并关联测点所属的模型:

  1. 登录 EnOS 管理控制台,进入 时序数据管理 > 存储策略 首页。
  2. 点击页面右上角的 + 图标,选择 手动添加(本教程以新建存储策略分组为例)。
  3. 填写存储策略分组名称,搜索并选中测点所属的模型(本教程使用的模型为 test_Model),将其关联至存储策略分组。
  4. 点击 确认,即可完成存储策略分组创建。


EnOS Edge: 编辑存储策略分组

EnOS Edge 用户无需创建存储策略分组,可通过以下步骤配置存储策略分组,并关联测点所属的模型:

  1. 点击 编辑分组,搜索并选中测点所属的模型(本教程使用的模型为 test_Model),将其关联至存储策略分组。
  2. 点击 确认,即可完成存储策略分组配置。

第二步:配置存储策略并发布

创建好存储策略分组后,可看到TSDB存储为不同的数据类型提供分类存储。本教程需选择 AI分钟级归一化数据,点击卡片右上角的编辑图标,进入该策略之后,需进行如下配置:

  • 数据存储时效:默认3个月。
  • 存储点选择:选中模型后,再选择需要存储的测点,本教程选择 test_Model 下的 test_raw 这个测点。


内容配置完成后,点击 确认 按钮即可完成存储策略的保存和发布,系统会根据配置对数据进行存储。当AI数据进入分钟级归一化数据存储TSDB时,系统会自动去除掉数据时间戳的秒级后缀,因此系统只会存储每一分钟内的最后一条入库的数据。

第三步:使用 TSDB 数据服务 API 获取聚合数据

使用AI分钟级规一化数据存储类型对应的 TSDB 数据服务 API 接口 Get Asset AI Data with Aggregation Logic,可获取已存储的测点数据。调用 Open API 的代码示例,参见 Get Asset AI Data with Aggregation Logic