Meilleures pratiques pour choisir un ID de série chronologique

Article
03/23/2021

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 récapitule l’importance de l’ID Time Series pour votre environnement Azure Time Series Insights Gen2 et les meilleures pratiques pour en choisir un.

Choisir un ID de série chronologique

La sélection d’un ID de série chronologique appropriée est essentielle. Le choix d’un ID Time Series est semblable au choix d’une clé de partition pour une base de données. Il est nécessaire lorsque vous créez un environnement Azure Time Series Insights Gen2.

Regardez le tutoriel de provisionnement de l’environnement pour obtenir une explication détaillée de l’ID de série chronologique. Vous allez afficher deux exemples de charge utile de télémétrie JSON différents et la sélection correcte de l’ID de série chronologique pour chacun d’eux.

Important

Les ID de série chronologique sont les suivants :

Une propriété de chaîne sensible à la casse : les casses de lettres et de caractères sont utilisées dans les recherches, les comparaisons, les mises à jour et lors de la partition.
Propriété immuable : une fois qu’elle a été créée, elle ne peut pas être modifiée.

Pourboire

Si votre source d’événement est un hub IoT, votre ID Time Series sera probablement iothub-connection-device-id. Si vous envisagez d’utiliser des modèles d’appareil IoT Plug-and-Play ou que vous les utilisez sans composants, vous devez inclure dt-subject dans le cadre de la clé composite au cas où vous en avez besoin à l’avenir.

Les meilleures pratiques clés à suivre sont les suivantes :

Choisissez une clé de partition avec de nombreuses valeurs distinctes (par exemple, des centaines ou des milliers). Dans de nombreux cas, il peut s’agir de l’ID d’appareil, de l’ID de capteur ou de l’ID de balise dans votre json.
L’ID de série chronologique doit être unique au niveau du nœud feuille de votre modèle de série chronologique .
La longueur maximale pour le nom de propriété de l'ID de série temporelle est de 128 caractères. Pour la valeur de la propriété de l’ID Time Series, la limite de caractères est de 1 024.
Si une valeur de propriété unique pour l’ID Time Series est manquante, elle est traitée comme une valeur Null et suit la même règle de la contrainte d’unicité.
Si votre ID Time Series est imbriqué dans un objet JSON complexe, veillez à suivre les règles d’entrée les règles d’aplatissement lors de la fourniture de votre nom de propriété. Consultez l’exemple B.
Vous pouvez également sélectionner jusqu'à trois propriétés principales comme votre ID de série chronologique ,. Leur combinaison est une clé composite qui représente l’ID de série chronologique.

Note

Vos trois propriétés clés doivent être des chaînes. Vous devrez interroger cette clé composite plutôt qu'une propriété à la fois.

Sélectionner plusieurs propriétés clés

Les scénarios suivants décrivent la sélection de plusieurs propriétés clés en tant qu'ID de série temporelle.

Exemple 1 : ID de série chronologique avec une clé unique

Vous avez des parcs d'équipements anciens. Chacun a une clé unique.
Une flotte est identifiée de manière unique par la propriété deviceId. Pour une autre flotte, la propriété unique est ID d'objet. Aucune des flottes ne contient la propriété unique de l’autre flotte. Dans cet exemple, vous devez sélectionner deux clés, deviceId et objectId, en tant que clés uniques.
Nous acceptons les valeurs nulles et l'absence d'une propriété dans la charge utile de l'événement compte comme une valeur nulle. Il s’agit également de la façon appropriée de gérer l’envoi de données à deux sources d’événements où les données de chaque source d’événement ont un ID Time Series unique.

Exemple 2 : ID de série chronologique avec une clé composite

Vous avez besoin que plusieurs propriétés soient uniques dans la même flotte d’actifs.
Vous êtes fabricant de bâtiments intelligents et déployez des capteurs dans chaque pièce. Dans chaque pièce, vous avez généralement les mêmes valeurs pour sensorId. Par exemple, capteur1, capteur2et capteur3.
Votre bâtiment a des numéros d'étage et de chambre qui se chevauchent à travers les sites de la propriété flrRm. Ces nombres ont des valeurs telles que 1a, 2bet 3a.
Vous avez une propriété, emplacement, qui contient des valeurs telles que Redmond, Barceloneet Tokyo. Pour créer unicité, vous désignez les trois propriétés suivantes comme clés d’ID de série chronologique : sensorId, flrRmet emplacement.

Exemple d’événement brut :

{
  "sensorId": "sensor1",
  "flrRm": "1a",
  "location": "Redmond",
  "temperature": 78
}

Dans le portail Azure, vous pouvez ensuite entrer la clé composite comme suit :

Note

Dans le portail Azure, n’entrez pas de noms séparés par des virgules de propriétés dans une texbox ; sinon, il sera traité comme un nom de propriété unique qui contient des virgules. Entrez chaque nom de propriété dans sa propre texbox.

Étapes suivantes

Lisez les règles d’aplatissement et d’échappement JSON et pour comprendre comment les événements seront stockés.
Planifiez votre environnement Azure Time Series Insights Gen2.

Partager via