IoT Platform:Reenviar datos a ApsaraDB RDS

Funcionamiento

La función de reenvío de datos enruta mensajes desde temas de dispositivos hacia una tabla en una base de datos de ApsaraDB RDS, que es un servicio de base de datos administrado. Para obtener más información, consulte What is ApsaraDB RDS?.

En la figura anterior:

• Origen de datos: Mensajes provenientes de tipos de temas compatibles. Para obtener más información sobre los formatos de datos admitidos, consulte Data formats.

• Expresión SQL: Escriba una expresión SQL para analizar y procesar datos JSON de los dispositivos. Para obtener más información sobre la sintaxis SQL, consulte SQL expressions.

  Nota

  Los datos binarios se transmiten sin ser analizados.

• Destino de datos: Una tabla en una base de datos que pertenece a una instancia de ApsaraDB RDS for MySQL o ApsaraDB RDS for SQL Server dentro de una Virtual Private Cloud (VPC). Esta tabla recibe los datos del dispositivo.

Límites

• Restricciones de región:

  • Las instancias de IoT Platform en regiones específicas admiten el reenvío de datos a ApsaraDB RDS. Para obtener más información sobre las regiones compatibles, consulte Feature availability by region.

  • La instancia de ApsaraDB RDS debe estar en la misma región que su instancia de IoT Platform. Por ejemplo, los datos de una instancia de IoT Platform en la región China (Shanghai) solo se pueden reenviar a una tabla en una instancia de ApsaraDB RDS en la región China (Shanghai).

• Solo puede reenviar datos a instancias de ApsaraDB RDS en una Virtual Private Cloud (VPC).

• Se admiten instancias de ApsaraDB RDS for MySQL y ApsaraDB RDS for SQL Server.

• Los datos se pueden reenviar a bases de datos estándar y de privilegios elevados.

• El reenvío de datos solo admite datos en formato JSON.

• Tanto la versión nueva como la anterior de la función de reenvío de datos admiten el enrutamiento de datos a ApsaraDB RDS. Para ver un ejemplo con la versión nueva, consulte Forward data to ApsaraDB RDS (new version).

• La versión anterior del reenvío de datos no se puede utilizar para productos y dispositivos de puerta de enlace en la nube, ni para productos y dispositivos bajo una instancia basada en MQTT. Para reenviar datos de estos productos y dispositivos, debe usar la versión nueva de reenvío de datos. Para obtener más información, consulte Data forwarding (new version).

• Para conocer más limitaciones sobre el reenvío de mensajes de dispositivos desde una instancia de IoT Platform, consulte Limitations.

Requisitos previos

• Una instancia de ApsaraDB RDS for MySQL o ApsaraDB RDS for SQL Server en una VPC, ubicada en la misma región que su instancia de IoT Platform. Debe haber creado una base de datos y una tabla en la instancia. Para obtener más información sobre cómo usar ApsaraDB RDS, consulte ApsaraDB RDS documentation.

• Una regla de reenvío de datos con una expresión SQL para procesar los datos. Para obtener más información, consulte Create a rule to process data.

Contexto

Después de configurar el destino de datos, el motor de reglas de IoT Platform realiza automáticamente las siguientes configuraciones para reenviar datos de dispositivos a ApsaraDB RDS.

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

• Se crea un security group administrado en la VPC donde se encuentra la instancia de ApsaraDB RDS. El nombre del security group comienza con sg-nsm- de forma predeterminada.

Configurar el destino de datos

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 el ID o nombre de la instancia.

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 ApsaraDB RDS para el parámetro Operation. Configure los demás parámetros y haga clic en OK.

   Parámetro	Descripción
   Operation	Seleccione Store Data to ApsaraDB RDS.
   Region	La región donde reside su instancia de IoT Platform. Este parámetro es fijo.
   RDS instance	Seleccione la instancia de ApsaraDB RDS de destino.
   Database	Introduzca el nombre de la base de datos. Nota Para una base de datos de privilegios elevados, debe introducir el nombre de la base de datos manualmente.
   Account	Introduzca el nombre de usuario de la instancia de ApsaraDB RDS. Esta cuenta debe tener permisos de lectura y escritura en la base de datos. De lo contrario, el motor de reglas no podrá escribir datos en la instancia de ApsaraDB RDS. Nota Una vez que el motor de reglas obtiene la cuenta, solo escribe en la base de datos los datos que coinciden con la regla y no realiza ninguna otra operación.
   Password	Introduzca la contraseña de la cuenta de la base de datos.
   Table name	Introduzca el nombre de la tabla que creó en la base de datos. El motor de reglas escribirá los datos en esta tabla.
   Key	Introduzca un nombre de columna de la tabla de ApsaraDB RDS. El motor de reglas almacenará los datos en esta columna.
   Value	Introduzca un campo de la carga útil del mensaje del tema definido en la expresión SQL. El motor de reglas almacenará el valor de este campo en la columna especificada por Key. Nota El tipo de datos de Value debe coincidir con el tipo de datos de Key (columna). De lo contrario, la operación de escritura fallará. Puede introducir una variable, como ${deviceName}.
   Role	Seleccione un rol de RAM que permita a IoT Platform escribir datos en ApsaraDB RDS. Si no existe ningún rol de RAM, haga clic en Create RAM Role para crear un rol de RAM y una política de autorización en la consola de RAM. Create a RAM role.

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

8. En la consola de ApsaraDB RDS, en la página Data Security, configure la lista blanca. El motor de reglas requiere una conexión a ApsaraDB RDS. Después de configurar el destino de datos, el motor de reglas agrega automáticamente sus direcciones IP a la lista blanca de ApsaraDB RDS. Si las siguientes direcciones IP no están en la lista blanca, debe agregarlas manualmente.ApsaraDB RDS

   • China (Shanghai): 100.104.53.192/26,100.104.148.64/26,100.104.6.192/26,100.104.143.128/26,100.104.76.0/24,100.104.73.128/26,100.104.200.64/26,100.104.40.64/26,100.104.3.0/26,100.104.29.128/26,100.104.121.0/26,100.104.84.64/26

   • Asia Pacific (Singapore): 100.104.106.0/24

   • US (Silicon Valley): 100.104.8.0/24

   • US (Virginia): 100.104.133.64/26

   • Germany (Frankfurt): 100.104.160.192/26

   • Japan (Tokyo): 100.104.160.192/26

   En el panel de navegación izquierdo de su instancia de ApsaraDB RDS, haga clic en Data Security. En la pestaña Whitelist settings, haga clic en Add whitelist group y agregue al grupo los bloques CIDR de direcciones IP correspondientes a la región de IoT Platform.