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
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.
Rubriques
Prérequis
Pour suivre ce didacticiel, vous aurez besoin des éléments suivants :
-
Un Compte AWS. 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 ?
-
Un utilisateur AWS Identity and Access Management (IAM) doté d'autorisations d'administrateur. Pour obtenir des instructions complètes, veuillez consulter Comment AWS IoT SiteWise fonctionne avec IAM.
-
Une AWS IoT SiteWise démo en cours d'exécution. Pour de plus amples informations, veuillez consulter Utiliser la AWS IoT SiteWise démo.
Note
Ce didacticiel nécessite l'utilisation de ressources créées dans leUtiliser la AWS IoT SiteWise démo. Vous devez le terminer avant de poursuivre ce didacticiel.
Important
Conservez toutes les ressources de démonstration jusqu'à ce que vous ayez terminé ce didacticiel. La suppression de composants peut perturber les fonctionnalités de la démo et affecter votre capacité à terminer le didacticiel.
É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 message MQTT envoyé à AWS IoT Core.
Pour activer les notifications de mise à jour de valeur des propriétés de ressources
-
Connectez-vous à la console AWS IoT SiteWise
. -
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.
-
Dans le panneau de navigation de gauche, choisissez Assets (Ressources).
-
Sélectionnez la flèche en regard de Demo Wind Farm Asset pour développer la hiérarchie de la ressource du parc éolien.
-
Choisissez une éolienne de démonstration et choisissez Edit (Modifier).
-
Choisissez Measurements (Mesures).
-
Mettez à jour le statut de notification MQTT de la Wind Speedpropriété sur ACTIVE.
-
En bas de la page, sélectionnez Save (Enregistrer).
-
Répétez les étapes 5 à 7 pour chaque ressource d'éolienne de démonstration.
-
Choisissez une turbine de démonstration (par exemple, Demo Turbine Asset 1).
-
Choisissez Measurements (Mesures).
-
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
-
Accédez à la console AWS IoT
. -
Dans le volet de navigation de gauche, choisissez Routage des messages, puis sélectionnez Règles.
-
Choisissez Créer une règle.
-
Sous Spécifier les propriétés de la règle, entrez le nom et la description de la règle.
-
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-33333EXAMPLERemplacez l'ID de ressource (l'ID après
assets/) 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 -
Entrez l'instruction de requête de règle suivante. Remplacez la rubrique de la section
FROMpar 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' -
Sous Actions relatives aux règles, accédez à Action 1.
-
Sur la page Sélectionner une action, choisissez Dynamo. DBv2 Cela divise le message en plusieurs colonnes d'une table DynamoDB
-
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.
-
Dans le champ Nom de la table dans la console DynamoDB
, entrez le nom de votre table. -
Pour la clé de partition, procédez comme suit :
-
Pour la clé de partition, saisissez
timestamp. -
Choisissez le type Numéro .
-
Cochez la case Ajouter une clé de tri.
-
Pour la clé de tri, saisissez
assetet laissez le type de clé de tri par défaut Chaîne.
-
-
Choisissez Créer un tableau.
-
Retournez à l'onglet avec la page Configure action (Configurer l'action).
-
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
-
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.
-
Entrez un nom de rôle, par exemple,
WindSpeedDataRole. Choisissez Créer un rôle. -
Choisissez Suivant.
-
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
-
Retournez à l'onglet avec la table DynamoDB ouverte.
-
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).
-
Dans une ligne du tableau, choisissez l'icône de modification pour développer les données.
-
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, vous pouvez désactiver ou supprimer la règle et supprimer votre table DynamoDB pour éviter des frais supplémentaires. Pour nettoyer vos ressources, voirNettoyage des ressources .
Vous pouvez également apprendre à créer des applications personnalisées pour utiliser et visualiser ces données. Pour un didacticiel guidé sur la visualisation AWS IoT SiteWise des données, voirVisualisez et partagez des données dans Grafana.
Nettoyage des ressources
Une fois que vous avez terminé le didacticiel, nettoyez les ressources pour éviter d'encourir des frais supplémentaires.
Pour supprimer la AWS IoT SiteWise démo
Accédez à la console AWS IoT SiteWise
. Dans le coin supérieur droit de la page, choisissez Supprimer la démo.
Dans le champ de confirmation, entrez,
DELETE, puis choisissez Delete (Supprimer).
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
-
Accédez à la console AWS IoT SiteWise
. -
Dans le panneau de navigation de gauche, choisissez Assets (Ressources).
-
Sélectionnez la flèche en regard de Demo Wind Farm Asset pour développer la hiérarchie de la ressource du parc éolien.
-
Choisissez une éolienne de démonstration et choisissez Edit (Modifier).
-
Mettez à jour le statut de notification de la Wind Speedpropriété sur INACTIF.
-
En bas de la page, choisissez Save asset (Enregistrer la ressource).
-
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
-
Accédez à la console AWS IoT
. -
Dans le volet de navigation de gauche, choisissez Routage des messages, puis Règles.
-
Sélectionnez votre règle, puis cliquez sur Supprimer.
-
Dans la boîte de dialogue de confirmation, entrez le nom de la règle, puis choisissez Supprimer.
Pour supprimer une table DynamoDB
-
Accédez à la console DynamoDB
. -
Dans le volet de navigation de gauche, choisissez Tables.
-
Choisissez le tableau que vous avez créé précédemment, par exemple
WindSpeedData. -
Sélectionnez Delete (Supprimer).
-
Dans la boîte de dialogue de confirmation, entrez
confirmpour supprimer le tableau.
Ressources supplémentaires
Pour plus d'informations sur l'utilisation de DynamoDB et la surveillance de vos données, consultez les ressources suivantes :
-
Surveillance des métriques incluses dans le CloudWatch Guide du développeur DynamoDB
-
Les meilleures pratiques pour concevoir et utiliser efficacement les clés de partition sont décrites dans le Guide du développeur DynamoDB
-
Règles figurant AWS IoT dans le guide du AWS IoT développeur