数据转发到实例内的时序数据存储

限制说明

• 仅华东2（上海）、华北2（北京）、华南1（深圳）地域支持实例内的时序数据存储，实例内的时序数据存储详情请参见时序数据存储管理。
• 只支持JSON格式数据转发。
• 转发的消息中，除了配置的timestamp、tag值字段外，其他字段都将作为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的消息中，筛选出time、city、power和distance字段内容，作为转发的消息内容。

   通过以上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