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](https://aws.amazon.com/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, consultez[Surveillez les données avec AWS IoT SiteWise Monitor](monitor-data.md).
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](interact-with-other-services.md).
**Topics**
+ [Conditions préalables](#dynamodb-tutorial-prerequisites)
+ [Étape 1 : Configuration AWS IoT SiteWise pour publier les mises à jour de la valeur des propriétés](#dynamodb-tutorial-enable-value-notifications)
+ [Étape 2 : créer une règle dans AWS IoT Core](#dynamodb-tutorial-create-iot-rule)
+ [Étape 3 : Configuration de l'action de la règle DynamoDB](#dynamodb-tutorial-configure-rule-action)
+ [Étape 4 : explorer les données dans DynamoDB](#dynamodb-tutorial-explore-dynamodb-data)
+ [nettoyer des ressources ;](#dynamodb-tutorial-clean-up-resources)
+ [Ressources supplémentaires](#dynamodb-tutorial-additional-resources)
## Conditions préalables
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](getting-started.md#set-up-aws-account).
+ 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 ?](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/what-is.html)
+ Un utilisateur Gestion des identités et des accès AWS (IAM) doté d'autorisations d'administrateur. Pour obtenir des instructions complètes, consultez [Comment AWS IoT SiteWise fonctionne avec IAM](security_iam_service-with-iam.md).
+ 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](getting-started-demo.md).
**Note**
Ce didacticiel nécessite l'utilisation de ressources créées dans le[Utiliser la AWS IoT SiteWise démo](getting-started-demo.md). 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**
1. Connectez-vous à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Passez en revue les [AWS IoT SiteWise points de terminaison et les quotas](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html) 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.
1. Dans le panneau de navigation de gauche, choisissez **Assets (Ressources)**.
1. Sélectionnez la flèche en regard de **Demo Wind Farm Asset** pour développer la hiérarchie de la ressource du parc éolien.
1. Choisissez une éolienne de démonstration et choisissez **Edit (Modifier)**.
1. Choisissez **Measurements (Mesures)**.
1. Mettez à jour le **statut de notification MQTT de la **Wind Speed****propriété sur **ACTIVE**.
1. En bas de la page, sélectionnez **Save** (Enregistrer).
1. Répétez les étapes 5 à 7 pour chaque ressource d'éolienne de démonstration.
1. Choisissez une turbine de démonstration (par exemple, **Demo Turbine Asset 1**).
1. Choisissez **Measurements (Mesures)**.
1. 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](https://console.aws.amazon.com/iot/).
1. Dans le volet de navigation de gauche, choisissez **Routage des messages**, puis sélectionnez **Règles**.
1. Choisissez **Créer une règle**.
1. Sous **Spécifier les propriétés de la règle**, entrez le nom et la description de la règle.
1. 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è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
```
1. 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'
```
1. Sous **Actions relatives aux règles**, accédez à **Action 1**.
1. Sur la page **Sélectionner une action**, choisissez **Dynamo. DBv2** Cela divise le message en plusieurs colonnes d'une table DynamoDB
1. 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.
1. Dans le **champ Nom de la table** dans la console [DynamoDB](https://console.aws.amazon.com/dynamodb/), entrez le nom de votre table.
1. Pour **la clé de partition**, procédez comme suit :
1. Pour la clé de partition, saisissez **timestamp**.
1. Choisissez le type **Numéro** .
1. Cochez la case ** Ajouter une clé de tri**.
1. Pour la clé de tri, saisissez **asset** et laissez le type de clé de tri par défaut **Chaîne**.
1. Choisissez **Créer un tableau**.
1. Retournez à l'onglet avec la page **Configure action (Configurer l'action)**.
1. 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.
1. Entrez un nom de rôle, par exemple,`WindSpeedDataRole`. Choisissez **Créer un rôle**.
1. Choisissez **Suivant**.
1. 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.
1. 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)](troubleshoot-rule.md#dynamodb-tutorial-troubleshoot-rule).
1. Dans une ligne du tableau, choisissez l'icône de modification pour développer les données.
1. 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](query-notification-messages.md).
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, voir[nettoyer des ressources ;](#dynamodb-tutorial-clean-up-resources).
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, voir[Visualisez et partagez des données dans Grafana](visualize-with-grafana.md).
## nettoyer 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**
1. Accédez à la [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Dans le coin supérieur droit de la page, choisissez **Supprimer** la démo.
1. 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](getting-started-demo.md#delete-getting-started-demo).
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](https://console.aws.amazon.com/iotsitewise/).
1. Dans le panneau de navigation de gauche, choisissez **Assets (Ressources)**.
1. Sélectionnez la flèche en regard de **Demo Wind Farm Asset** pour développer la hiérarchie de la ressource du parc éolien.
1. Choisissez une éolienne de démonstration et choisissez **Edit (Modifier)**.
1. Mettez à jour le **statut de notification** de la **Wind Speed**propriété sur **INACTIF**.
1. En bas de la page, choisissez **Save asset (Enregistrer la ressource)**.
1. 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](https://console.aws.amazon.com/iot/).
1. Dans le volet de navigation de gauche, choisissez **Routage des messages**, puis **Règles**.
1. Sélectionnez votre règle, puis cliquez **sur Supprimer**.
1. 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](https://console.aws.amazon.com/dynamodb/).
1. Dans le volet de navigation de gauche, choisissez **Tables**.
1. Choisissez le tableau que vous avez créé précédemment, par exemple`WindSpeedData`.
1. Sélectionnez **Delete (Supprimer)**.
1. Dans la boîte de dialogue de confirmation, entrez **confirm** pour 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](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Monitoring-metrics-with-Amazon-CloudWatch.html) le CloudWatch Guide du *développeur DynamoDB*
+ [Les meilleures pratiques pour concevoir et utiliser efficacement les clés de partition sont décrites dans](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html) le Guide du *développeur DynamoDB*
+ [Règles figurant AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) dans le *guide du AWS IoT développeur*
+ [Visualisez et partagez des données dans Grafana](visualize-with-grafana.md)