Transformer les données (transformations)

Les transformations sont des expressions mathématiques qui mappent les points de données des propriétés de ressource d’un formulaire vers un autre. Une expression de transformation comprend des variables de propriété d'actif, des littéraux, des opérateurs et des fonctions. Les points de données transformés entretiennent une relation biunivoque avec les points de données d'entrée. AWS IoT SiteWise calcule un nouveau point de données transformé chaque fois que l'une des propriétés d'entrée reçoit un nouveau point de données.

Par exemple, si votre ressource a un flux de mesure de température nommé Temperature_C avec des unités en Celsius, vous pouvez convertir chaque point de données en Fahrenheit avec la formule Temperature_F = 9/5 * Temperature_C + 32. Chaque fois AWS IoT SiteWise qu'un point de données est reçu dans le flux de Temperature_C mesures, la Temperature_F valeur correspondante est calculée en quelques secondes et disponible en tant que Temperature_F propriété.

Si votre transformation contient plusieurs variables, le point de données qui arrive le plus tôt lance immédiatement le calcul. Prenons l'exemple d'un fabricant de pièces qui utilise une transformation pour contrôler la qualité de ses produits. En utilisant une norme différente en fonction du type de pièce, le fabricant utilise les mesures suivantes pour représenter le processus :

Le fabricant crée également une transformationQuality_Monitor, qui équivaut à if(eq(Part_Number, "BLT123") and (Bad_Count / (Good_Count + Bad_Count) > 0.1), "Caution", "Normal").

Cette transformation surveille le pourcentage de pièces défectueuses produites pour un type de pièce spécifique. Si le numéro de pièce est BLT123 et que le pourcentage de pièces défectueuses dépasse 10 % (0,1), la transformation est renvoyée. "Caution" Dans le cas contraire, la transformation est renvoyée"Normal".

Définir les transformations (console)

Lorsque vous définissez une transformation pour un modèle d'actif dans la AWS IoT SiteWise console, vous spécifiez les paramètres suivants :

Pour de plus amples informations, veuillez consulter Création d'un modèle d'actif (console).

Définissez les transformations (AWS CLI)

Lorsque vous définissez une transformation pour un modèle d'actif à l'aide de l' AWS IoT SiteWise API, vous spécifiez les paramètres suivants :

{
...
"assetModelProperties": [
...
{
  "name": "Temperature F",
  "dataType": "DOUBLE",
  "type": {
    "transform": {
      "expression": "9/5 * temp_c + 32",
      "variables": [
        {
          "name": "temp_c",
          "value": {
            "propertyId": "Temperature C"
          }
        }
      ]
    }
  },
  "unit": "Fahrenheit"
}
],
...
}

{
...
"assetModelProperties": [
...
{
"name": "Quality_Monitor",
"dataType": "STRING",
"type": {
    "transform": {
        "expression": "if(eq(Part_Number,"BLT123") and (Bad_Count / (Good_Count + Bad_Count) > 0.1), "Caution", "Normal")",
        "variables": [
            {
                "name": "Part_Number",
                "value": {
                    "propertyId": "Part Number"
                }
            },
            {
                "name": "Good_Count",
                "value": {
                    "propertyId": "Good Count"
                }
            },
            {
                "name": "Bad_Count",
                "value": {
                    "propertyId": "Bad Count"
                }
            }
        ]
    }
}
}
...
}