数据转发到时序时空数据库_数据流转使用示例_规则引擎_消息通信

使用须知

目前转发至TSDB仅发布在华东2节点。
只支持专有网络（VPC）下TSDB实例。
只支持数据在同地域内转发。例如：华东2地域的设备数据只能转发到华东2的TSDB实例中。
只支持JSON格式数据转发。
不支持时序数据库InfluxDB版。
不支持时空数据库。
转发的消息中，除了配置为timestamp和tag值的字段外，其他字段都将作为metric写入时序时空数据库。metric的值只能为数值类型，否则会导致写入数据库失败。

更多TSDB相关信息，请参见时序时空数据库（TSDB）使用指南。

准备工作

在设置转发之前，请参见设置数据流转规则，创建数据转发规则和编写处理数据的SQL。

操作步骤

在规则详情页，单击数据转发一栏的添加操作。

按照界面提示，设置参数。


参数	描述
选择操作	选择存储到时序时空数据库（TSDB）中。
VPC实例	选择数据转发目标为您已创建的专有网络（VPC）中的TSDB实例。
timestamp	时间戳。支持：使用转义符`${}`表达式，如`${time}`，表示timestamp的值为规则SQL中指定Topic对应数据包中time字段对应的值。使用数据流转函数`timestamp()`，表示timestamp的值为数据流转服务器的时间戳。输入值，必须为Unix时间戳，如1404955893000。
tag	设置标记数据的标签名。支持中文汉字、英文字母、数字、和特殊字符包括：半角冒号（:）、逗号（,）、点号（.）、单引号（'）、正斜线（/）、连字符（-）、下划线（_）、圆括号()、方括号[]。
值	设置标签值。支持：使用转义符`${}`表达式，如`${city}`，表示标签值为规则SQL中指定Topic对应数据包中city字段对应的值。建议使用此方式。使用数据流转函数规定的一些函数，如`deviceName()`，表示标签值为设备名称。输入常量，例如beijing。支持输入中文汉字、英文字母、数字、和特殊字符包括：半角冒号（:）、逗号（,）、点号（.）、单引号（'）、正斜线（/）、连字符（-）、下划线（_）、圆括号()、方括号[]。说明最多可添加8个tag键-值对。需保证TSDB能够获取到配置的tag键-值对，如果获取不到任意一个tag键-值对，会导致写入数据库失败。
角色	授予物联网平台向TSDB写数据的权限。物联网平台会向TSDB实例中添加网络白名单，用于物联网平台访问您的TSDB数据库，请勿删除这些IP段。若TSDB实例白名单中未出现物联网平台IP：100.104.76.0/24，请手动添加。

示例

规则的SQL如下：
```
SELECT time,city,power,distance, FROM "/myproduct/myDevice/update"`；
```
以上SQL从Topic /myproduct/myDevice/update的消息中，筛选出time、city、power、distance字段内容，作为转发的消息内容。

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

{
"time": 1513677897,
"city": "beijing",
"distance": 8545,
"power": 93.0
}

配置的数据转发规则，请见上一章节操作步骤中截图示例。

根据数据转发规则，向TSDB中写入的两条数据：

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

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

写入TSDB的数据说明：

以上转发的消息中，除了配置为timestamp的time字段和配置为tag值的city字段外，其他字段（power和distance）都作为metric写入时序时空数据库。

实践案例

将数据转发至时序时空数据库(TSDB)