IoT Platform:Transférer des données vers ApsaraDB RDS

Fonctionnement

La fonctionnalité de transfert de données achemine les messages provenant des rubriques d'appareils vers une table d'une base de données ApsaraDB RDS, un service de base de données managé. Pour plus d'informations, consultez Présentation d'ApsaraDB RDS.

Dans le schéma précédent :

• Source de données : Messages provenant des types de rubrique pris en charge. Pour plus d'informations sur les formats de données pris en charge, consultez Formats de données.

• Expression SQL : Rédigez une expression SQL pour analyser et traiter les données JSON des appareils. Pour plus d'informations sur la syntaxe SQL, consultez Expressions SQL.

  Remarque

  Les données binaires sont transmises sans analyse.

• Destination des données : Une table d'une base de données appartenant à une instance ApsaraDB RDS for MySQL ou ApsaraDB RDS for SQL Server au sein d'un VPC (Virtual Private Cloud). Cette table reçoit les données de l'appareil.

Limites

• Restrictions régionales :

  • Les instances IoT Platform situées dans certaines régions prennent en charge le transfert de données vers ApsaraDB RDS. Pour plus d'informations sur les régions prises en charge, consultez Disponibilité des fonctionnalités par région.

  • L'instance ApsaraDB RDS doit se trouver dans la même région que votre instance IoT Platform. Par exemple, les données d'une instance IoT Platform dans la région Chine (Shanghai) ne peuvent être transférées que vers une table d'une instance ApsaraDB RDS située dans la région Chine (Shanghai).

• Vous ne pouvez transférer des données que vers des instances ApsaraDB RDS situées dans un VPC (Virtual Private Cloud).

• Les instances ApsaraDB RDS for MySQL et ApsaraDB RDS for SQL Server sont prises en charge.

• Les données peuvent être transférées vers des bases de données standard et à privilèges élevés.

• Le transfert de données prend uniquement en charge les données au format JSON.

• Les versions nouvelle et héritée de la fonctionnalité de transfert de données prennent toutes deux en charge le routage des données vers ApsaraDB RDS. Pour un exemple utilisant la nouvelle version, consultez Transférer des données vers ApsaraDB RDS (nouvelle version).

• La version héritée du transfert de données ne peut pas être utilisée pour les produits et appareils de passerelle cloud, ni pour les produits et appareils sous une instance basée sur MQTT. Pour transférer des données depuis ces produits et appareils, vous devez utiliser la nouvelle version du transfert de données. Pour plus d'informations, consultez Transfert de données (nouvelle version).

• Pour plus d'informations sur les autres limites relatives au transfert des messages d'appareil depuis une instance IoT Platform, consultez Limites.

Prérequis

• Une instance ApsaraDB RDS for MySQL ou ApsaraDB RDS for SQL Server dans un VPC, située dans la même région que votre instance IoT Platform. Une base de données et une table doivent avoir été créées dans l'instance. Pour plus d'informations sur l'utilisation d'ApsaraDB RDS, consultez la documentation ApsaraDB RDS.

• Une règle de transfert de données avec une expression SQL pour traiter les données. Pour plus d'informations, consultez Créer une règle pour traiter les données.

Informations générales

Après avoir configuré la destination des données, le moteur de règles IoT Platform effectue automatiquement les configurations suivantes pour transférer les données de l'appareil vers ApsaraDB RDS.

• IoT Platform consomme deux adresses IP du vSwitch où réside l'instance ApsaraDB RDS. Le bloc CIDR IPv4 du vSwitch est ajouté à la liste d'autorisation de l'instance ApsaraDB RDS.

• Un groupe de sécurité managé est créé dans le VPC où se trouve l'instance ApsaraDB RDS. Le nom du groupe de sécurité commence par sg-nsm- par défaut.

Configurer la destination des données

1. Connectez-vous à la console IoT Platform.

2. Sur la page Overview, recherchez l'instance que vous souhaitez gérer et cliquez sur son ID ou son nom.

3. Dans le volet de navigation de gauche, choisissez Message Forwarding > Data Forwarding.

4. Cliquez sur View à côté de la règle cible. La page Data Forwarding Rule s'affiche.

   Important

   Si la page Data Forwarding (New Version) s'affiche, cliquez sur Back to Previous Version dans le coin supérieur droit, puis cliquez sur View à côté de la règle cible.

5. Dans la section Forward Data, cliquez sur Add Operation.

6. Dans la boîte de dialogue Add Operation, sélectionnez Store Data to ApsaraDB RDS pour le paramètre Operation. Configurez les autres paramètres et cliquez sur OK.

   Paramètre	Description
   Opération	Sélectionnez Store Data to ApsaraDB RDS.
   Région	La région où réside votre instance IoT Platform. Ce paramètre est fixe.
   Instance RDS	Sélectionnez l'instance ApsaraDB RDS de destination.
   Base de données	Saisissez le nom de la base de données. Remarque Pour une base de données à privilèges élevés, vous devez saisir manuellement le nom de la base de données.
   Compte	Saisissez le nom d'utilisateur de l'instance ApsaraDB RDS. Ce compte doit disposer des autorisations de lecture et d'écriture sur la base de données. Sinon, le moteur de règles ne pourra pas écrire de données dans l'instance ApsaraDB RDS. Remarque Une fois que le moteur de règles a obtenu le compte, il écrit uniquement les données correspondant à la règle dans la base de données et n'effectue aucune autre opération.
   Mot de passe	Saisissez le mot de passe du compte de la base de données.
   Nom de la table	Saisissez le nom de la table que vous avez créée dans la base de données. Le moteur de règles écrit les données dans cette table.
   Clé	Saisissez un nom de colonne de la table ApsaraDB RDS. Le moteur de règles stocke les données dans cette colonne.
   Valeur	Saisissez un champ de la charge utile du message de la rubrique défini dans l'expression SQL. Le moteur de règles stocke la valeur de ce champ dans la colonne spécifiée par Key. Remarque Le type de données de la Value doit correspondre au type de données de la Key (colonne). Sinon, l'opération d'écriture échouera. Vous pouvez saisir une variable, telle que ${deviceName}.
   Rôle	Sélectionnez un rôle RAM qui permet à IoT Platform d'écrire des données dans ApsaraDB RDS. Si aucun rôle RAM n'existe, cliquez sur Create RAM Role pour créer un rôle RAM et une politique d'autorisation dans la console RAM. Créer un rôle RAM.

7. Sur la page Data Forwarding, recherchez la règle et cliquez sur Start dans la colonne Actions.

8. Dans la console ApsaraDB RDS, sur la page Data Security, configurez la liste d'autorisation. Le moteur de règles nécessite une connexion à ApsaraDB RDS. Après avoir configuré la destination des données, le moteur de règles ajoute automatiquement ses adresses IP à la liste d'autorisation d'ApsaraDB RDS. Si les adresses IP suivantes ne figurent pas dans la liste d'autorisation, vous devez les ajouter manuellement.ApsaraDB RDS

   • Chine (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

   • Asie-Pacifique (Singapour) : 100.104.106.0/24

   • États-Unis (Silicon Valley) : 100.104.8.0/24

   • États-Unis (Virginie) : 100.104.133.64/26

   • Allemagne (Francfort) : 100.104.160.192/26

   • Japon (Tokyo) : 100.104.160.192/26

   Dans le volet de navigation de gauche de votre instance ApsaraDB RDS, cliquez sur Data Security. Sous l'onglet Whitelist settings, cliquez sur Add whitelist group et ajoutez les blocs CIDR d'adresses IP correspondant à la région IoT Platform au groupe.