使用企业版实例时,可以配置数据流转规则,将数据转发到实例内的时序数据存储中存储。

限制说明

  • 仅华东2(上海)、华北2(北京)、华南1(深圳)地域支持实例内的时序数据存储,实例内的时序数据存储详情请参见时序数据存储管理
  • 只支持JSON格式数据转发。
  • 转发的消息中,除了配置的timestamptag值字段外,其他字段都将作为metric写入时序数据存储。metric的数据类型支持数值型、字符串,其他类型会导致写入失败。

前提条件

已创建数据转发规则和编写处理数据的SQL,请参见设置数据流转规则

操作步骤

  1. 登录物联网平台控制台
  2. 实例概览页面,选择目标环境,找到对应的实例,单击实例ID或备注名称。
    重要 目前仅开通企业版实例服务的地域下,执行此步骤。其他地域,请跳过此步骤。地域及实例的支持说明,请参见实例概述
    实例概览
  3. 在左侧导航栏,选择消息转发 > 云产品流转
  4. 单击规则对应的查看,进入数据流转规则页面。
    重要 若当前页面为云产品流转新版页面,需先单击右上角返回旧版,再单击目标规则对应的查看
  5. 单击转发数据一栏对应的添加操作
  6. 添加操作对话框中,选择操作为存储到实例内的时序数据存储中。按照界面提示,设置其他信息,单击确认
    参数描述
    选择操作选择存储到实例内的时序数据存储中
    地域固定为您的物联网平台实例所在地域。
    metric数据类型选择metric的数据类型。支持数值型字符串

    更多信息,可单击帮助按钮帮助查看。

    timestamp时间戳。支持:
    • 使用转义符${}表达式,例如${time},表示取值为数据源Topic消息中time字段对应的值。
    • 使用数据流转函数timestamp(),表示取值为数据流转服务器的时间戳。
    • 输入值,必须为Unix时间戳,例如1404955893000。
    tag名称设置标记数据的标签名。支持中文汉字、英文字母、数字、和特殊字符,包括:半角冒号(:)、逗号(,)、英文句号(.)、单引号(')、正斜线(/)、短划线(-)、下划线(_)、圆括号(())、方括号([])。
    tag值设置标签值。支持:
    • 使用转义符${}表达式。例如,数据源Topic的消息结构中,包含一个位置属性,标识符为city,则可以指定标签值为${city},表示消息中city字段对应的值。建议使用此方式。
    • 使用数据流转函数规定的一些函数,例如deviceName(),表示标签值为设备名称。支持的函数,请参见函数列表
    • 输入常量,例如beijing。支持输入中文汉字、英文字母、数字、和特殊字符包括:半角冒号(:)、逗号(,)、英文句号(.)、单引号(')、正斜线(/)、短划线(-)、下划线(_)、圆括号(())、方括号([])。
    说明
    • 最多可添加8个tag键值对。
    • 需保证时序数据存储能够获取到配置的tag键值对,如果获取不到任意一个tag键值对,会导致写入数据库失败。
  7. 回到云产品流转页,单击规则对应的启动按钮启动规则。

数据流转示例

示例规则的SQL:

SELECT time,city,power,distance, FROM "/alprodu****/myDevice/user/update";

规则引擎根据SQL处理数据和写入数据到时序数据存储如下。

  1. 根据该SQL,规则引擎从Topic /alprodu****/myDevice/user/update的消息中,筛选出timecitypowerdistance字段内容,作为转发的消息内容。

    通过以上SQL处理后的转发消息内容示例如下:

    {
        "time": 1513677897,
        "city": "beijing",
        "distance": 8545,
        "power": 93.0
    }
  2. 根据已配置的数据流转操作,规则引擎向时序数据存储中写入两条数据。

    示例中写入时序数据存储的数据如下:

    • 数据:timestamp:1513677897, [metric:power value:93.0]
      tag: cityName=beijing
    • 数据:timestamp:1513677897, [metric:distance value:8545]
      tag: cityName=beijing

执行结果

时序数据将通过数据流转,写入实例内的时序数据存储。您可以通过以下两种方式进行查询: