配置自定义Topic数据存储

通过数据存储的热数据存储规则功能,可将指定的自定义Topic数据流转到热数据存储空间进行存储。本文介绍配置自定义Topic数据到热数据存储空间的完整操作步骤。

前提条件

  • 当前实例为标准型或尊享型企业版实例,并已购买需要的热数据IOPS和热数据存储空间。具体操作,请参见购买企业版实例

  • 设备已添加自定义Topic。具体操作,请参见自定义Topic

背景信息

设备上报的物模型数据会自动写入热数据存储空间,设备上报的自定义Topic数据需您手动创建热数据存储规则进行解析,才能存储到热数据存储空间。

热数据存储的详细说明,请参见热数据存储概述

步骤一:创建热数据存储规则

说明

每个实例下最多添加1000个热数据存储规则。

  1. 登录物联网平台控制台

  2. 实例概览页面,找到对应的企业版实例,单击实例进入实例详情页面。

  3. 在左侧导航栏,选择数据服务 > 数据存储

  4. 热数据存储页签下的存储规则页签,单击创建规则

  5. 填写参数后,单击确定

    参数

    描述

    规则名称

    输入规则名称。支持中文、英文字母、日文、数字、下划线(_)和短划线(-),长度为1~30个字符,一个中文或日文占2个字符。

    规则描述

    规则描述信息。

    创建规则成功后,您可在存储规则列表查看已添加的存储规则。

步骤二:添加自定义Topic

说明

每个规则下最多添加1000个Topic。

  1. 热数据存储页签下的存储规则页签下, 找到对应的存储规则,单击对应操作列的查看

  2. 规则详情页面的Topic页签,单击添加Topic

  3. 在弹出的对话框中,根据页面提示,选择产品、设备和自定义Topic。

    说明

    Topic支持使用通配符(+)和(#):

    • 全部设备(+):指定产品下所有设备。

    • /user/#:指定设备的所有自定义Topic。

    image
  4. 单击确定

    添加自定义Topic成功后,Topic页签下显示已添加的Topic信息。

    重要

    已添加自定义Topic不支持修改,您可先删除,然后重新添加。

    image

步骤三:编写脚本

  1. 规则详情页面,单击脚本页签。

  2. 在编辑脚本输入框中,输入脚本解析自定义Topic数据,将数据存入热数据存储空间。

    脚本编辑方法和示例,请参见脚本语法

    重要

    同一热数据存储规则下,同一字段key对应value的数据类型必须保持不变。若发生改变(例如:int32类型改为text类型),则新数据的写入会失败,且无法再查询历史存储数据。

  3. 单击保存,完成脚本编辑。

步骤四:调试并发布脚本

  1. 在规则详情页面的脚本页签,单击调试

  2. 在右侧调试面板,根据页面提示,选择产品和设备,输入Topic和Payload数据,单击调试,验证脚本。

    输入的TopicPayload数据,与脚本解析逻辑相符即可。image

    运行结果中会显示脚本中声明的变量值和执行的数据存储函数。image

  3. 单击调试面板的关闭

  4. 单击脚本页签右下角的发布

步骤五:启动规则

所有设置完成后,返回至热数据存储页面的规则存储页签,单击规则对应的启动。规则启动后,设备上报的自定义Topic数据即可按照解析脚本进行存储。

可选操作

您也在热数据存储页面的规则存储页签,执行以下操作:

操作

说明

查看

规则详情页面,更新规则中Topic和脚本设置。例如,删除自定义Topic、更新脚本。

删除

删除对应规则。

重要

运行中的规则不可删除。

停止

停止对应规则。

重要

停止成功后,对应自定义Topic数据不再存入热数据存储空间。

阿里云首页 物联网平台 相关技术圈