Publier les mises à jour de la valeur des propriétés sur Amazon DynamoDB

Ce didacticiel présente un moyen pratique de stocker vos données à l'aide d'Amazon DynamoDB, afin de faciliter l'accès aux données historiques des actifs sans avoir à interroger l'API à plusieurs reprises. AWS IoT SiteWise Une fois ce didacticiel terminé, vous pouvez créer un logiciel personnalisé qui utilise les données de vos actifs, comme une carte en temps réel de la vitesse et de la direction du vent sur l'ensemble d'un parc éolien. Si vous souhaitez surveiller et visualiser vos données sans implémenter de solution logicielle personnalisée, consultezSurveillez les données avec AWS IoT SiteWise Monitor.

Dans ce didacticiel, vous vous appuierez sur la AWS IoT SiteWise démo qui fournit un exemple de jeu de données pour un parc éolien. Vous configurez les mises à jour de la valeur des propriétés à partir de la démonstration du parc éolien pour envoyer des données, via des règles de AWS IoT base, à une table DynamoDB que vous créez. Lorsque vous activez les mises à jour de la valeur des propriétés, AWS IoT SiteWise envoie vos données AWS IoT Core dans des messages MQTT. Définissez ensuite des règles de AWS IoT base qui exécutent des actions, telles que l'action DynamoDB, en fonction du contenu de ces messages. Pour de plus amples informations, veuillez consulter Interagissez avec d'autres AWS services.

Prérequis

Pour suivre ce didacticiel, vous aurez besoin des éléments suivants :

• Un AWS compte. Si vous n'en avez pas, veuillez consulter Configurez un AWS compte.

• Un ordinateur de développement exécutant Windows, macOS, Linux ou Unix pour accéder au AWS Management Console. Pour plus d'informations, voir Qu'est-ce que le AWS Management Console ?

• Utilisateur IAM possédant des autorisations de niveau administrateur. Pour obtenir des instructions complètes, veuillez consulter Comment AWS IoT SiteWise fonctionne avec IAM.

• Une démonstration de AWS IoT SiteWise parc éolien en cours d'exécution. Lorsque vous configurez la démo, elle définit les modèles et les actifs AWS IoT SiteWise et leur transmet des données pour représenter un parc éolien. Pour de plus amples informations, veuillez consulter Utiliser la AWS IoT SiteWise démo.

Étape 1 : Configuration AWS IoT SiteWise pour publier les mises à jour de la valeur des propriétés

Dans cette procédure, vous activez les notifications de valeur de propriété au niveau des propriétés Wind Speed des ressources des éoliennes de la démonstration. Après avoir activé les notifications de valeur de propriété, AWS IoT SiteWise publie chaque mise à jour de valeur dans un message MQTT envoyé à AWS IoT Core.

Pour activer les notifications de mise à jour de valeur des propriétés de ressources

1. Connectez-vous à la console AWS IoT SiteWise.

2. Passez en revue les AWS IoT SiteWise points de terminaison et les quotas pris en charge et changez de AWS région, si nécessaire. AWS IoT SiteWise Basculez vers la région dans laquelle vous exécutez la AWS IoT SiteWise démo.

3. Dans le panneau de navigation de gauche, choisissez Assets (Ressources).

4. Sélectionnez la flèche en regard de Demo Wind Farm Asset pour développer la hiérarchie de la ressource du parc éolien.

5. Choisissez une éolienne de démonstration et choisissez Edit (Modifier).

6. Choisissez Measurements (Mesures).

7. Mettez à jour le statut de notification MQTT de la Wind Speedpropriété sur ACTIVE.

8. En bas de la page, sélectionnez Save (Enregistrer).

9. Répétez les étapes 5 à 7 pour chaque ressource d'éolienne de démonstration.

10. Choisissez une turbine de démonstration (par exemple, Demo Turbine Asset 1).

11. Choisissez Measurements (Mesures).

12. Choisissez l'icône de copie en regard de la propriété Wind Speed pour copier la rubrique de notification dans votre presse-papiers. Enregistrez la rubrique de notification qui sera utilisée ultérieurement dans ce didacticiel. Vous avez seulement besoin d'enregistrer la rubrique de notification d'une éolienne.

    La rubrique de notification doit ressembler à l'exemple suivant.

    $aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE

Étape 2 : créer une règle dans AWS IoT Core

Au cours de cette étape, créez une règle dans AWS IoT Core qui analyse les messages de notification relatifs à la valeur de la propriété et insère les données dans une table Amazon DynamoDB. AWS IoT Les règles de base analysent les messages MQTT et exécutent des actions en fonction du contenu et du sujet de chaque message. Vous créez ensuite une règle avec une action DynamoDB pour insérer des données dans une table DynamoDB que vous créez dans le cadre de ce didacticiel.

Pour créer une règle avec une action DynamoDB

1. Accédez à la console AWS IoT.

2. Dans le volet de navigation de gauche, choisissez Routage des messages, puis sélectionnez Règles.

3. Choisissez Créer une règle.

4. Sous Spécifier les propriétés de la règle, entrez le nom et la description de la règle.

5. Recherchez la rubrique de notification que vous avez enregistrée précédemment dans ce didacticiel.

   $aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE

   Remplacez l'ID de ressource (l'ID aprèsassets/) dans la rubrique par un+. Cela permet de sélectionner la propriété de vitesse du vent pour tous les actifs d'éoliennes de démonstration. Le filtre de rubrique + accepte tous les nœuds d'un seul niveau dans une rubrique. Votre sujet doit ressembler à l'exemple suivant.

   $aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/+/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE

6. Entrez l'instruction de requête de règle suivante. Remplacez la rubrique de la section FROM par votre rubrique de notification.

   SELECT
     payload.assetId AS asset,
     (SELECT VALUE (value.doubleValue) FROM payload.values) AS windspeed,
     timestamp() AS timestamp
   FROM
     '$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/+/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE' 
   WHERE
     type = 'PropertyValueUpdate'

7. Sous Actions relatives aux règles, accédez à Action 1.

8. Sur la page Sélectionner une action, choisissez Dynamo. DBv2 Cela divise le message en plusieurs colonnes d'une table DynamoDB

9. Sous Nom de la table, choisissez Créer une nouvelle table. Vous créez une table Amazon DynamoDB pour recevoir les données de vitesse du vent issues de l'action de la règle.

10. Dans le champ Nom de la table dans la console DynamoDB, entrez le nom de votre table.

11. Pour la clé de partition, procédez comme suit :

    1. Pour la clé de partition, saisissez timestamp.

    2. Choisissez le type Numéro .

    3. Cochez la case Ajouter une clé de tri.

    4. Pour la clé de tri, saisissez asset et laissez le type de clé de tri par défaut Chaîne.

12. Choisissez Créer un tableau.

13. Retournez à l'onglet avec la page Configure action (Configurer l'action).

14. Sur la page d'action Joindre une règle, actualisez la liste des noms de table et choisissez la nouvelle table DynamoDB que vous avez créée à l'étape précédente.

Étape 3 : Configuration de l'action de la règle DynamoDB

Au cours de cette étape, configurez l'action de règle Amazon DynamoDB pour insérer les données issues des mises à jour des valeurs de propriété dans votre nouvelle table DynamoDB.

Pour configurer l'action de règle DynamoDB

1. Choisissez Create role pour créer un rôle IAM qui accorde un accès AWS IoT Core pour exécuter l'action de règle.

2. Entrez un nom de rôle, par exemple,WindSpeedDataRole. Choisissez Créer un rôle.

3. Choisissez Suivant.

4. Choisissez Créer au bas de la page pour terminer la création de la règle.

   Les données de vos actifs de démonstration devraient commencer à apparaître dans votre table DynamoDB.

Étape 4 : explorer les données dans DynamoDB

Au cours de cette étape, explorez les données de vitesse du vent des actifs de démonstration dans votre nouveau tableau Amazon DynamoDB.

Pour explorer les données relatives aux actifs dans DynamoDB

1. Retournez à l'onglet avec la table DynamoDB ouverte.

2. Dans le tableau que vous avez créé précédemment, cliquez sur l'onglet Explorer les éléments du tableau pour afficher les données du tableau. Actualisez la page si la table ne comporte aucune ligne. Si aucune ligne n'apparaît après quelques minutes, consultez Résolution des problèmes liés à une règle (DynamoDB).

3. Dans une ligne du tableau, choisissez l'icône de modification pour développer les données.

4. Choisissez la flèche en regard de la structure windspeed pour développer la liste des points de données de vitesse du vent. Chaque liste reflète un lot de points de données sur la vitesse du vent envoyés AWS IoT SiteWise par la démo du parc éolien. Vous pouvez avoir besoin d'un format de données différent si vous configurez une action de règle adaptée à votre utilisation. Pour de plus amples informations, veuillez consulter Interrogez les notifications relatives aux propriétés des actifs dans AWS IoT SiteWise.

Maintenant que vous avez terminé le didacticiel, désactivez ou supprimez la règle et supprimez votre table DynamoDB pour éviter des frais supplémentaires. Pour nettoyer vos ressources, voirÉtape 5 : Nettoyer les ressources après le didacticiel.

Étape 5 : Nettoyer les ressources après le didacticiel

Une fois que vous avez terminé le didacticiel, nettoyez les ressources pour éviter d'encourir des frais supplémentaires. Les actifs de votre parc éolien de démonstration sont supprimés à la fin de la durée que vous avez choisie lors de la création de la démo. Vous pouvez également supprimer la démo manuellement.

La AWS IoT SiteWise démo se supprime d'elle-même au bout d'une semaine, ou après le nombre de jours que vous avez choisi si vous avez créé la pile de démonstration depuis la AWS CloudFormation console. Vous pouvez supprimer la démo auparavant si vous avez fini d'utiliser les ressources de démonstration. Vous pouvez également supprimer la démo si la démo ne parvient pas à créer. Suivez les étapes suivantes pour supprimer manuellement la démo.

(facultatif) Pour supprimer la AWS IoT SiteWise démo

1. Accédez à la console AWS CloudFormation.

2. TSiteWiseDemoAssetsChoisissez Io dans la liste des Stacks.

3. Sélectionnez Delete (Supprimer).

   Lorsque vous supprimez la pile, toutes les ressources créées pour la démonstration sont supprimées.

4. Dans la boîte de dialogue de confirmation, choisissez Delete (Supprimer).

   La suppression de la pile prend environ 15 minutes. Si la suppression de la démonstration échoue, choisissez à nouveau Delete (Supprimer) dans le coin supérieur droit. Si la démo ne parvient pas à être supprimée à nouveau, suivez les étapes de la AWS CloudFormation console pour ignorer les ressources qui n'ont pas pu être supprimées, puis réessayez.

Pour de plus amples informations, veuillez consulter Supprimer la AWS IoT SiteWise démo.

Utilisez les procédures suivantes pour désactiver les notifications de mise à jour de la valeur des propriétés (si vous n'avez pas supprimé la démo), désactiver ou supprimer votre AWS IoT règle et supprimer votre table DynamoDB.

Pour désactiver les notifications de mise à jour de valeur des propriétés de ressources

1. Accédez à la console AWS IoT SiteWise.

2. Dans le panneau de navigation de gauche, choisissez Assets (Ressources).

3. Sélectionnez la flèche en regard de Demo Wind Farm Asset pour développer la hiérarchie de la ressource du parc éolien.

4. Choisissez une éolienne de démonstration et choisissez Edit (Modifier).

5. Mettez à jour le statut de notification de la Wind Speedpropriété sur INACTIF.

6. En bas de la page, choisissez Save asset (Enregistrer la ressource).

7. Répétez les étapes 4 à 6 pour chaque ressource d'éolienne de démonstration.

Pour désactiver ou supprimer une règle dans AWS IoT Core

1. Accédez à la console AWS IoT.

2. Dans le volet de navigation de gauche, choisissez Routage des messages, puis Règles.

3. Sélectionnez votre règle, puis cliquez sur Supprimer.

4. Dans la boîte de dialogue de confirmation, entrez le nom de la règle, puis choisissez Supprimer.

Pour supprimer une table DynamoDB

1. Accédez à la console DynamoDB.

2. Dans le volet de navigation de gauche, choisissez Tables.

3. Choisissez le tableau que vous avez créé précédemment, par exempleWindSpeedData.

4. Sélectionnez Delete (Supprimer).

5. Dans la boîte de dialogue de confirmation, entrez confirm pour supprimer le tableau.