Types de données pris en charge
Notes
Le service Time Series Insights (TSI) ne sera plus pris en charge après le mois de mars 2025. Pensez à migrer dès que possible les environnements TSI existants vers d’autres solutions. Pour plus d’informations sur la dépréciation et la migration, consultez notre documentation.
Le tableau suivant répertorie les types de données qu’Azure Time Series Insights Gen2 prend en charge
| Type de données | Description | Exemple | Syntaxe Time Series Expression | Nom de la colonne de propriété dans Parquet |
|---|---|---|---|---|
| bool | Type de données ayant l’un des deux états suivants : true ou false. |
"isQuestionable" : true |
$event.isQuestionable.Bool ou $event['isQuestionable'].Bool |
isQuestionable_bool |
| datetime | Représente un instant, généralement exprimé sous la forme d’une date ou d’une heure. Valeur exprimée au format ISO 8601. Les propriétés DateHeure sont toujours stockées au format UTC. Les décalages de fuseau horaire, s’ils sont correctement mis en forme, sont appliqués, puis la valeur stockée au format UTC. Pour plus d’informations sur la propriété horodateur de l’environnement et les décalages DateHeure, consultez cette section | "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" |
Si « eventProcessedLocalTime » est l’horodateur de la source de l’événement : $event.$ts. Si c’est une autre propriété JSON : $event.eventProcessedLocalTime.DateTime ou $event['eventProcessedLocalTime'].DateTime |
eventProcessedLocalTime_datetime |
| double | 64 bits double précision | "value": 31.0482941 |
$event.value.Double ou $event['value'].Double |
value_double |
| long | Entier 64 bits signé | "value" : 31 |
$event.value.Long ou $event['value'].Long |
value_long |
| string | Les valeurs de texte doivent être au format UTF-8 valide. Les chaînes Null et vides sont traitées de la même façon. | "site": "DIM_MLGGG" |
$event.site.String ou $event['site'].String |
site_string |
| dynamic | Type complexe (non primitif) constitué d’un tableau ou d’un conteneur de propriétés (dictionnaire). À l’heure actuelle, seuls des tableaux JSON convertis de primitives ou des tableaux d’objets ne contenant pas l’ID TS ou les propriétés d’horodatage sont stockés comme dynamiques. Pour comprendre la façon dont les objets sont aplatis et les tableaux peuvent être déroulés, lisez cet article . Les propriétés de charge utile stockées avec ce type sont accessibles uniquement en sélectionnant Explore Events dans l’Explorateur Time Series Insights pour afficher les événements bruts, ou via l’GetEventsAPI de requête pour l’analyse côté client. |
"values": "[197, 194, 189, 188]" |
Le référencement de types dynamiques dans une expression Time Series (TSX) n’est pas encore pris en charge | values_dynamic |
Notes
Les valeurs entières de 64 bits sont prises en charge, mais le plus grand nombre que l’Explorateur Azure Time Series Insights peut correctement exprimer est 9 007 199 254 740 991 (2^53-1) en raison de limitations propres à JavaScript. Si vous utilisez des nombres plus grands dans votre modèle de données, vous pouvez réduire la taille en créant une variable de modèle Time Series et en convertissant la valeur.
Notes
Le type String n’accepte pas les valeurs Null :
- Une expression Time Series (TSX) exprimée dans une requête Time Series qui compare la valeur d’une chaîne vide ('') par rapport à NULL se comporte de la même façon : équivaut à .
- L’API peut retourner des valeurs NULL même si les événements d’origine contenaient des chaînes vides.
- N’établissez pas de dépendance sur des valeurs NULL dans des colonnes String pour effectuer des comparaisons ou des évaluations, mais traitez-les de la même façon que des chaînes vides.
Envoi de types de données mixtes
Votre environnement Azure Time Series Insights Gen2 est très typé. Si des appareils ou des balises envoient des données de types différents pour une propriété d’appareil, les valeurs sont stockées dans deux colonnes séparées, et la fonction coalesce() doit être utilisée lors de la définition de vos expressions de variable de modèle de série chronologique dans les appels d’API.
L’Explorateur Azure Time Series Insights offre un moyen de fusionner automatiquement les colonnes distinctes de la même propriété d’appareil. Dans l’exemple ci-dessous, le capteur envoie une propriété PresentValue qui peut être une valeur Long ou Double. Pour effectuer une requête sur toutes les valeurs stockées (quel que soit le type de données) de la propriété PresentValue, choisissez PresentValue (Double | Long) et les colonnes seront fusionnées pour vous.
Objets et tableaux
Vous pouvez envoyer des types complexes tels que des objets et des tableaux dans le cadre de votre charge utile d’événement. Les objets imbriqués sont aplatis et les tableaux sont stockés comme dynamic ou aplatis pour produire plusieurs événements en fonction de la configuration de votre environnement et de la forme JSON. Pour en savoir plus, consultez les Règles de mise à plat et d’échappement de JSON
Étapes suivantes
Lisez les Règles de mise à plat et d’échappement JSON pour comprendre comment les événements seront stockés.
Comprendre les limites de débit de votre environnement
En savoir plus sur les sources d’événements pour ingérer les données de diffusion en continu.