Gestion des flux de données

Gérez vos flux de données à l'aide du Console AWS IoT SiteWise ou AWS CLI.

Console

Utilisez la AWS IoT SiteWise console pour gérer vos flux de données.

Pour gérer les flux de données (console)

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

2. Dans le volet de navigation, sélectionnez Data streams.

3. (Facultatif) Pour ajouter ou mettre à jour des balises, sélectionnez le flux de données à modifier, puis choisissez Gérer les balises.

   Sur la page Modifier les balises, choisissez Ajouter une étiquette. Dans le champ Clé, saisissez le nom de la balise à utiliser.

   Choisissez Enregistrer.

4. (Facultatif) Dans le tableau des flux de données, vous pouvez filtrer les flux de données de la manière suivante.

   • Dans le premier menu déroulant, sélectionnez Préfixe d'alias ou ID d'actif.

     • Préfixe d'alias : préfixe d'alias du flux de données. Vous pouvez choisir cette option si vos flux de données cibles ont un préfixe d'alias.

     • ID d'actif : ID de l'actif dans lequel la propriété de l'actif a été créée. Vous pouvez choisir cette option si vos flux de données cibles sont associés à une propriété d'actif.

   • Dans le deuxième menu déroulant, sélectionnez Tous les flux de données, Flux de données associés ou Flux de données dissociés.

     • Tous les flux de données : flux de données associés ou non à une propriété d'actif.

     • Flux de données associés : flux de données associés à une propriété d'actif.

     • Flux de données dissociés : flux de données qui ne sont pas associés à une propriété d'actif.

5. Sélectionnez les flux de données que vous gérez. AWS IoT SiteWise affiche les flux de données que vous avez sélectionnés dans un graphique en bas de page. Si vous en sélectionnez plus de 10, le graphique n'affichera que les 10 premiers.

6. (Facultatif) Configurez le graphique de la manière suivante.

   1. Pour la fonction d'agrégation, sélectionnez l'une des options suivantes.

      • Nombre de points de données : nombre total de points de données pour les variables données sur l'intervalle de temps actuel.

      • Moyenne — La moyenne des valeurs des variables données sur l'intervalle de temps actuel.

      • Somme — Somme des valeurs des variables données sur l'intervalle de temps actuel.

      • Minimum — Le minimum des valeurs des variables données sur l'intervalle de temps actuel.

      • Maximum — Le maximum des valeurs des variables données sur l'intervalle de temps actuel.

      Pour plus d’informations, consultez Utilisation de fonctions d'agrégation dans des expressions de formule.

   2. Pour Plages temporelles, sélectionnez l'une des options suivantes.

      • Dernière heure : le graphique affiche les données agrégées de la dernière heure.

      • 2 dernières heures : le graphique affiche les données agrégées des deux dernières heures.

      • 3 dernières heures : le graphique affiche les données agrégées des trois dernières heures.

      • 4 dernières heures — Le graphique affiche les données agrégées des quatre dernières heures.

   3. Pour Intervalle de temps, sélectionnez l'une des options suivantes.

      • 1 minute : agrège les données toutes les minutes sur la plage de temps spécifiée.

      • 1 heure : agrège les données toutes les heures sur la plage de temps spécifiée.

7. Choisissez Gérer les flux de données.

8. Dans la section Mettre à jour les associations de flux de données, dans la colonne Nom de la mesure, effectuez l'une des opérations suivantes.

   • Si le flux de données est associé à une mesure, supprimez l'association en cliquant sur l'icône de fermeture.

   • Si le flux de données n'est associé à aucune mesure, choisissez Choisir une mesure.

9. Dans le tableau Choisissez une mesure, naviguez jusqu'à l'actif cible, puis choisissez la mesure que vous associez.

10. (Facultatif) Dans la section Mettre à jour les alias des propriétés des actifs, entrez un alias unique pour chaque mesure.

11. Choisissez Mettre à jour.

La colonne Status peut afficher l'une des valeurs suivantes.

• En attente : vous mettez à jour l'association du flux de données ou l'alias de propriété de l'actif.

• Soumettre — La modification apportée à l'association ou à l'alias de propriété de l'actif est enregistrée.

• Erreur : AWS IoT SiteWise impossible de traiter votre demande de mise à jour de l'association du flux de données ou de l'alias de la mesure.

• Succès : vous avez correctement mis à jour l'association du flux de données ou l'alias de la mesure.

AWS CLI

Utilisez les opérations d'API suivantes pour gérer vos flux de données. Les exemples de code utilisent le AWS CLI.

• AssociateTimeSeriesToAssetProperty— Associe un flux de données (série chronologique) à une propriété d'actif.

• DisassociateTimeSeriesFromAssetProperty— Dissocie un flux de données d'une propriété d'actif.

• DeleteTimeSeries— Supprime un flux de données.

• DescribeTimeSeries— Récupère les informations relatives à un flux de données.

• ListTimeSeries— Récupère une liste paginée de flux de données.

AssociateTimeSeriesToAssetProperty

Pour associer un flux de données à une propriété d'actif, exécutez la commande suivante.

Important

La propriété d'actif spécifiée ne doit être actuellement associée à aucun flux de données.

• data-stream-aliasRemplacez-le par l'alias du flux de données que vous associez.

• Remplacez Asset-ID par l'ID de l'actif dans lequel la propriété de l'actif a été créée.

• Remplacez Property-ID par l'ID de la propriété de l'actif.

aws iotsitewise associate-time-series-to-asset-property \ 
                         --alias data-stream-alias \
                         --assetId asset-ID \
                         --propertyId property-ID

DisassociateTimeSeriesFromAssetProperty

Pour dissocier un flux de données d'une propriété de ressource, exécutez la commande suivante.

• data-stream-aliasRemplacez-le par l'alias du flux de données que vous dissociez.

• Remplacez Asset-ID par l'ID de l'actif dans lequel la propriété de l'actif a été créée.

• Remplacez Property-ID par l'ID de la propriété de l'actif.

aws iotsitewise disassociate-time-series-from-asset-property \ 
                         --alias data-stream-alias \
                         --assetId asset-ID \
                         --propertyId property-ID

DeleteTimeSeries

Pour supprimer un flux de données, exécutez la commande suivante.

data-stream-aliasRemplacez-le par l'alias du flux de données que vous supprimez.

aws iotsitewise delete-time-series --alias data-stream-alias

Pour identifier un flux de données, effectuez l'une des opérations suivantes :

• Si le flux de données n'est associé à aucune propriété d'actif, spécifiez le flux alias de données.

• Si le flux de données est associé à une propriété d'actif, spécifiez l'une des options suivantes :

  • Le alias du flux de données.

  • Le assetId et propertyId qui identifie la propriété de l'actif.

DescribeTimeSeries

Utilisez l'opération DescribeTimeSeries API pour vérifier si vous avez correctement associé ou dissocié un flux de données.

Pour récupérer des informations sur un flux de données, exécutez la commande suivante.

aws iotsitewise describe-time-series --alias data-stream-alias

Pour identifier un flux de données, effectuez l'une des opérations suivantes :

• Si le flux de données n'est associé à aucune propriété d'actif, spécifiez le flux alias de données.

• Si le flux de données est associé à une propriété d'actif, spécifiez l'une des options suivantes :

  • Le alias du flux de données.

  • Le assetId et propertyId qui identifie la propriété de l'actif.

ListTimeSeries

Utilisez l'opération ListTimeSeries API pour vérifier si vous avez correctement supprimé un flux de données.

Pour récupérer une liste paginée de flux de données, exécutez la commande suivante.

aws iotsitewise list-time-series