Partager via


Variables de modèle de série chronologique

Note

Le service Time Series Insights sera mis hors service le 7 juillet 2024. Envisagez de migrer des environnements existants vers d’autres solutions dès que possible. Pour plus d’informations sur la dépréciation et la migration, consultez notre documentation .

Cet article décrit les variables de modèle de série chronologique qui spécifient des règles de formule et de calcul sur les événements.

Chaque variable peut être l’un des trois types suivants : numérique, catégorielles et d’agrégation .

  • types de numériques fonctionnent avec des valeurs numériques continues.
  • Types de catégoriel fonctionnent avec un ensemble défini de valeurs discrètes.
  • Les types d’agrégation combinent plusieurs variables d’un type unique (toutes les catégories numériques ou toutes les catégories).

Le tableau suivant affiche les propriétés pertinentes pour chaque type de variable.

table de variables de modèle de série chronologique

Variables numériques

Propriété variable Description
Filtre de variables Les filtres sont des clauses conditionnelles facultatives pour limiter le nombre de lignes prises en compte pour le calcul.
Valeur de variable Valeurs de télémétrie utilisées pour le calcul provenant de l’appareil ou des capteurs ou transformées à l’aide d’expressions Time Series. Les variables de type numérique doivent être Double ou Long pour correspondre au type de données des données entrantes.
Interpolation des variables L’interpolation spécifie comment reconstruire un signal à l’aide de données existantes. 'étape et options d’interpolation de linéaire sont disponibles pour les variables numériques.
Agrégation de variables Effectuez des calculs via les fonctions d’agrégation prises en charge pour les types de variables numériques.

Les variables sont conformes à l’exemple JSON suivant :

"Interpolated Speed": {
  "kind": "numeric",
  "value": {
    "tsx": "$event['Speed-Sensor'].Double"
  },
  "filter": null,
  "interpolation": {
    "kind": "step",
    "boundary": {
      "span": "P1D"
    }
  },
  "aggregation": {
    "tsx": "right($value)"
  }
}

Variables catégorielles

Variable, propriété Description
Filtre de variables Les filtres sont des clauses conditionnelles facultatives pour limiter le nombre de lignes prises en compte pour le calcul.
Valeur de variable Valeurs de télémétrie utilisées pour le calcul provenant de l’appareil ou des capteurs. Les variables de type catégorielles doivent être Long ou String pour correspondre au type de données des données entrantes.
Interpolation des variables L’interpolation spécifie comment reconstruire un signal à l’aide de données existantes. L’option d’interpolation étape est disponible pour les variables catégorielles.
Catégories de variables Les catégories créent un mappage entre les valeurs provenant de l’appareil ou des capteurs vers une étiquette.
Catégorie par défaut pour la variable La catégorie par défaut concerne toutes les valeurs qui ne sont pas mappées dans la propriété « categories ».

Les variables sont conformes à l’exemple JSON suivant :

"Status": {
  "kind": "categorical",
  "value": {
     "tsx": "$event.Status.Long"
},
  "interpolation": {
    "kind": "step",
    "boundary": {
      "span" : "PT1M"
    }
  },
  "categories": [
    {
      "values": [0, 1, 2, 3],
      "label": "Good"
    },
    {
      "values": [4],
      "label": "Bad"
    }
  ],
  "defaultCategory": {
    "label": "Not Applicable"
  }
}

Variables d’agrégation

Propriété variable Description
Filtre de variables Les filtres sont des clauses conditionnelles facultatives pour limiter le nombre de lignes prises en compte pour le calcul.
Agrégation de variables Effectuez des calculs via les fonctions d’agrégation prises en charge pour les variables d’agrégation de type.

Les variables sont conformes à l’exemple JSON suivant :

"Speed Range": {
  "kind": "aggregate",
  "filter": null,
  "aggregation": {
    "tsx": "max($event.Speed.Double) - min($event.Speed.Double)"
  }
}

Les variables sont stockées dans la définition de type d’un modèle de série chronologique et peuvent être fournies en ligne via des API pour remplacer ou compléter la définition stockée.

Étapes suivantes

  • En savoir plus sur le modèle de séries chronologiques .

  • En savoir plus sur la définition de variables inline à l’aide des API de requête .