IoT Platform:Reenvío de datos a TSDB

Requisitos previos

• Debe haber creado una instancia de IoT Platform en una región compatible con el reenvío de datos a TSDB. Para obtener más información, consulte Feature availability by region.

• Debe haber creado una instancia de TSDB implementada en una virtual private cloud (VPC) en la región de Japan (Tokyo)documentación de TSDB

  华东2（上海）

  . Para obtener más información, consulte

  .

• Debe haber creado una regla de reenvío de datos y escrito una sentencia SQL para procesar los datos. Para obtener más información, consulte Configure a data forwarding rule.

Contexto

Después de configurar el destino de datos, el motor de reglas de IoT Platform realiza automáticamente las siguientes configuraciones para reenviar los datos del dispositivo a ApsaraDB RDS. a la instancia de TSDB mediante el motor de reglas de IoT Platform.

• IoT Platform ocupa dos direcciones IP del vSwitch donde reside la instancia de TSDB. El bloque CIDR IPv4 del vSwitch se agrega a la lista blanca de la instancia de TSDB.

• Se crea un security group administrado en la VPC donde reside la instancia de TSDB. El nombre predeterminado del security group comienza con sg-nsm-.

Límites

• Los datos solo se pueden reenviar dentro de la misma región. Por ejemplo, solo puede reenviar datos desde una instancia de IoT Platform implementada en la región de Japan (Tokyo)Japan (Tokyo)

  China (Shanghai)

  a una instancia de TSDB implementada en la región de

  China (Shanghai)

  .

• Solo puede reenviar datos a una instancia de TSDB implementada en una VPC.

• Solo puede reenviar datos en formato JSON.

• En los mensajes reenviados, todos los campos se escriben en TSDB como el metric, excepto los campos configurados como timestamp y tag value. Los tipos de datos del parámetro metric admiten valores numéricos y cadenas. Si utiliza otros tipos de datos, es posible que no se puedan escribir en la base de datos.

Notas de uso

Puede utilizar la versión nueva o la versión anterior de la función de reenvío de datos para enviar información a Lindorm. Para obtener más información sobre cómo usar la versión nueva de esta función, consulte Use the new version of the data forwarding feature to forward data to Lindorm.

Procedimiento

1. Inicie sesión en la consola de IoT Platform.

2. En la página Overview, busque la instancia que desea gestionar y haga clic en su ID o nombre.

3. En el panel de navegación izquierdo, seleccione Message Forwarding > Data Forwarding.

4. Haga clic en View junto a la regla objetivo. Aparecerá la página Data Forwarding Rule.

   Importante

   Si se muestra la página Data Forwarding (New Version), haga clic en Back to Previous Version en la esquina superior derecha y luego haga clic en View junto a la regla objetivo.

5. En la sección Forward Data, haga clic en Add Operation.

6. En el cuadro de diálogo Add Operation, seleccione Store Data to TSDB en la lista desplegable Operation. Siga las instrucciones de la página para establecer los demás parámetros y haga clic en OK.

   Parámetro	Descripción
   Operation	Seleccione Store Data to TSDB.
   Region	La región donde está implementada su instancia de IoT Platform: Japan (Tokyo)
   TSDB Instance	Especifique la instancia de TSDB en la VPC que ha creado como destino al cual se reenviarán los datos.
   metric Data Type	Especifique el tipo de datos del parámetro metric. Valores válidos: Numeric Type y String. Haga clic en el icono para obtener más información.
   timestamp	Marca de tiempo. Se admiten las siguientes configuraciones: Utilice una expresión de carácter de escape ${}. Por ejemplo, establezca el parámetro en ${time}. Esto indica que el valor del parámetro corresponde al valor del campo time en el mensaje del tema de origen de datos. Utilice la función del motor de reglas timestamp(). Esto indica que el valor del parámetro se establece en la marca de tiempo del servidor del motor de reglas. Introduzca un valor. El valor introducido debe ser una marca de tiempo UNIX. Por ejemplo, puede introducir 1404955893000.
   Tag Name	Especifique el nombre de la etiqueta que se utiliza para identificar los datos. El nombre de la etiqueta puede contener letras, dígitos y los siguientes caracteres especiales: :,.'/-_()[]
   Tag Value	Especifique el valor de la etiqueta. Se admiten las siguientes configuraciones: Utilice una expresión de carácter de escape ${}. Por ejemplo, si la estructura de un mensaje en un tema de origen de datos contiene una propiedad de ubicación cuya clave es city, puede establecer el valor de la etiqueta en ${city}. Esto indica que el valor del parámetro corresponde al valor del campo city en el mensaje. Se recomienda utilizar esta configuración. Utilice las funciones especificadas en el motor de reglas, como deviceName(). Esto indica que el valor de la etiqueta es el nombre del dispositivo. Para obtener más información sobre las funciones compatibles, consulte Functions. Introduzca una constante. Por ejemplo, puede introducir la constante beijing. El valor puede contener letras, dígitos y los siguientes caracteres especiales: :,.'/-_()[] Nota Puede agregar un máximo de ocho nombres de etiqueta y ocho valores de etiqueta. Asegúrese de que TSDB pueda obtener los nombres y valores de etiqueta configurados. Si TSDB no puede obtener el nombre o el valor de una etiqueta, los datos no se podrán escribir en la base de datos.
   Role	Otorgue a IoT Platform los permisos para escribir datos en TSDB.

7. En la página Data Forwarding, busque la regla y haga clic en Start en la columna Actions.

Ejemplos de reenvío de datos

El siguiente bloque de código proporciona un ejemplo de sentencia SQL en la regla de reenvío de datos:

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

La siguiente sección muestra cómo el motor de reglas procesa los datos y los escribe en TSDB basándose en la sentencia SQL.

1. La sentencia SQL de ejemplo muestra que el motor de reglas filtra los campos time, city, power y distance de los mensajes en el tema /alprodu****/myDevice/user/update y utiliza el contenido de los campos filtrados como contenido del mensaje a reenviar.

   El siguiente ejemplo muestra el contenido del mensaje a reenviar después de procesar los datos según la sentencia SQL anterior:

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

2. El motor de reglas escribe dos filas de datos en TSDB basándose en la operación de reenvío de datos configurada.

   En el ejemplo, se escriben los siguientes datos en TSDB:

   • Data: timestamp:1513677897, [metric:power value:93.0]
     tag: cityName=beijing

   • Data: timestamp:1513677897, [metric:distance value:8545]
     tag: cityName=beijing

   La siguiente sección describe cómo se escriben los datos en TSDB:

   En los mensajes reenviados anteriores, excepto por el campo time configurado como timestamp y el campo city configurado como tag value, los demás campos (power y distance) se escriben en TSDB como el metric.