Publier les mises à jour de la valeur des propriétés sur Amazon DynamoDB - AWS IoT SiteWise
PrérequisÉtape 1 : Configuration AWS IoT SiteWise pour publier les mises à jour de la valeur des propriétésÉtape 2 : créer une règle dans AWS IoT CoreÉtape 3 : Création d'une table DynamoDBÉtape 4 : Configuration de l'action de la règle DynamoDBÉtape 5 : explorer les données dans DynamoDBÉtape 6 : Nettoyer les ressources après le didacticiel

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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, en facilitant l'accès aux données historiques des actifs sans avoir à les interroger à plusieurs reprises. AWS IoT SiteWise API 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, vos données sont AWS IoT SiteWise envoyées AWS IoT Core dans MQTT des messages. 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 Compte AWS.

  • Un ordinateur de développement exécutant Windows, macOS, Linux ou Unix pour accéder au AWS Management Console. Pour plus d'informations, consultez Démarrer avec le AWS Management Console.

  • Utilisateur IAM possédant des autorisations de niveau administrateur.

  • 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. Une fois que vous avez activé les notifications de valeur de propriété, AWS IoT SiteWise publie chaque mise à jour de valeur dans un MQTT message 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).

    AWS IoT SiteWise Capture d'écran de l'élément de navigation de gauche « Assets ».

  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.

    AWS IoT SiteWise Capture d'écran de la hiérarchie Demo Wind Farm Asset « ».

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

    AWS IoT SiteWise « Demo Turbine Asset » capture d'écran.

  6. Mettez à jour le statut de notification de la Wind Speedpropriété sur ENABLED.

    AWS IoT SiteWise Capture d'écran « Modifier le statut des notifications ».

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

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

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

  10. Choisissez Measurements (Mesures).

  11. 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.

    AWS IoT SiteWise Capture d'écran « Copier le sujet de notification ».

    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

Dans cette procédure, vous 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 des données dans une table Amazon DynamoDB. AWS IoT Les règles de base analysent MQTT les messages 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. Si un bouton Get started (Démarrer) apparaît, sélectionnez-le.

  2. Dans le panneau de navigation de gauche, choisissez Act (Agir) puis Rules (Règles).

    AWS IoT Capture d'écran de base « Créer une règle ».

  3. Si une boîte de dialogue Vous ne possédez pas encore de règle s'affiche, choisissez Créer une règle. Sinon, cliquez sur Create.

  4. Saisissez un nom et une description pour la règle.

    AWS IoT Capture d'écran de la page principale « Créer une règle » avec « Nom » et « Description » surlignés.

  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 Définissez une ou plusieurs actions, choisissez Ajouter une action.

    AWS IoT Capture d'écran de la page principale « Créer une règle » avec « Ajouter une action » en surbrillance.

  8. Sur la page Sélectionner une action, choisissez Diviser le message en plusieurs colonnes d'une table DynamoDB (ynamoDBvD 2).

    AWS IoT Capture d'écran de la page principale « Sélectionner une action » avec l'action ynamoDBv D2 surlignée.

  9. En bas de la page, choisissez Configure action (Configurer l'action).

  10. Sur la page Configure action, choisissez Create a new resource.

    La console DynamoDB s'ouvre dans un nouvel onglet. Laissez l'onglet de l'action de la règle ouvert pendant que vous effectuez les procédures suivantes.

Étape 3 : Création d'une table DynamoDB

Dans cette procédure, vous créez une table Amazon DynamoDB pour recevoir les données de vitesse du vent issues de l'action de la règle.

Pour créer une table DynamoDB

  1. Dans le tableau de bord de la console DynamoDB, choisissez Create table.

  2. Saisissez un nom pour votre table.

    Capture d'écran de la page DynamoDB « Créer une table ».

  3. Pour Clé primaire, 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.

  4. Sélectionnez Create (Créer).

    Lorsque le message La table est en cours de création. disparaît, votre table est prête.

  5. Retournez à l'onglet avec la page Configure action (Configurer l'action). Gardez l'onglet DynamoDB ouvert pendant que vous effectuez les procédures suivantes.

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

Dans cette procédure, vous 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. Sur la page Configurer l'action, actualisez la liste des noms de table et choisissez votre nouvelle table DynamoDB.

    AWS IoT Capture d'écran de la page principale « Configurer l'action D ynamoDBv 2 » avec le moteur de recherche de table surligné.

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

  3. Saisissez un nom de rôle, puis choisissez Create role (Créer un rôle).

    AWS IoT Capture d'écran de la page principale « Configurer l'action D ynamoDBv 2 » avec « Créer un rôle » surligné.

  4. Choisissez Add action.

  5. Choisissez Create rule (Créer une règle) 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 5 : explorer les données dans DynamoDB

Dans cette procédure, vous allez explorer les données de vitesse du vent des actifs de démonstration dans votre nouvelle table Amazon DynamoDB.

Pour explorer les données relatives aux actifs dans DynamoDB

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

  2. Dans la table que vous avez créée précédemment, choisissez l'onglet Éléments pour afficher les données de la table. 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).

    Capture d'écran de la page du tableau DynamoDB avec l'onglet « Éléments » surligné.

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

    Capture d'écran d'une page de table DynamoDB avec l'icône d'édition surlignée sur une ligne.

  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 Messages de notification relatifs aux propriétés des actifs.

    Capture d'écran du panneau « Modifier la ligne du tableau » de DynamoDB.

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 6 : Nettoyer les ressources après le didacticiel.

Étape 6 : 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. 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).

    AWS IoT SiteWise Capture d'écran de l'élément de navigation de gauche « Assets ».

  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.

    AWS IoT SiteWise Capture d'écran de la hiérarchie Demo Wind Farm Asset « ».

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

    AWS IoT SiteWise « Demo Turbine Asset » capture d'écran.

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

    AWS IoT SiteWise Capture d'écran « Modifier le statut des notifications ».

  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 panneau de navigation de gauche, choisissez Act (Agir) puis Rules (Règles).

  3. Choisissez le menu de votre règle et choisissez Désactiver ou Supprimer.

    AWS IoT Capture d'écran de la page « Règles » de base avec le menu d'une règle ouvert et surligné.
Pour supprimer une table DynamoDB

  1. Accédez à la console DynamoDB.

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

  3. Choisissez la table que vous avez créée précédemment WindSpeedData.

  4. Choisissez Supprimer la table.

    Capture d'écran de la page DynamoDB « Table » avec « Supprimer le tableau » surligné.

  5. Dans la boîte de dialogue Delete table (Supprimer la table), choisissez Delete (Supprimer).

    Capture d'écran de la boîte de dialogue « Supprimer la table » de DynamoDB avec « Supprimer » surligné.