Types de données pris en charge
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 .
Le tableau suivant répertorie les types de données pris en charge par Azure Time Series Insights Gen2
| Type de données | Description | Exemple | Syntaxe d'expression pour les séries temporelles | Nom de 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 dans l’heure, généralement exprimé sous la forme d’une date et d’une heure de jour. Exprimé au format ISO 8601. Les propriétés Datetime sont toujours stockées au format UTC. Les décalages de fuseau horaire, s’ils sont correctement mis en forme, seront appliqués, puis la valeur sera stockée en UTC. Consultez cette section pour plus d’informations sur la propriété de l'horodatage de l’environnement et les décalages de date et d'heure. | "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" |
Si « eventProcessedLocalTime » est l’horodatage de la source d’événement : $event.$ts. S’il s’agit d’une autre propriété JSON : $event.eventProcessedLocalTime.DateTime ou $event['eventProcessedLocalTime'].DateTime |
eventProcessedLocalTime_datetime |
| double | Nombre à double précision de 64 bits | "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 |
| chaîne | Les valeurs de texte doivent être constituées d’UTF-8 valides. 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 |
| dynamique | Type complexe (non primitif) constitué d’un tableau ou d’un conteneur de propriétés (dictionnaire). Actuellement, seuls les tableaux JSON stringifiés de primitives ou de tableaux d’objets qui ne contiennent pas la propriété TS ID ou timestamp(ies) seront stockés en tant que dynamiques. Lisez cet article pour comprendre comment les objets seront aplatis et les tableaux peuvent être déroulés. Les propriétés de charge utile stockées comme 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’API de requête GetEvents pour l’analyse côté client. |
"values": "[197, 194, 189, 188]" |
Le référencement de types dynamiques dans une expression Time Series n’est pas encore pris en charge | values_dynamic |
Note
Les valeurs entières 64 bits sont prises en charge, mais le plus grand nombre que l’Explorateur Azure Time Series Insights peut exprimer en toute sécurité est de 9 007 199 254 740 991 (2^53-1) en raison des limitations JavaScript. Si vous travaillez avec des nombres dans votre modèle de données ci-dessus ce dernier, vous pouvez réduire la taille en créant une variable de modèle de série chronologique et en convertissant la valeur.
Note
Le type de chaîne ne peut pas être nul :
- Une expression de série temporelle (TSX)
exprimée dans une requête de série temporelle comparant la valeur d’une chaîne vide ( '' ) avecNULL se comportera de la même manière :équivaut à . - L’API peut retourner des valeurs NULL même si les événements d’origine étaient des chaînes vides.
- Ne pas se fier aux valeurs NULL dans les colonnes chaîne pour effectuer des comparaisons ou des évaluations, et traitez-les comme des chaînes vides.
Envoi de types de données mixtes
Votre environnement Azure Time Series Insights Gen2 est fortement typé. Si les appareils ou 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'Azure Time Series Insights Explorer 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 à la fois longue 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 coalescé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 en tant que 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, lisez à propos des règles d’aplatissement et d’échappement JSON
Étapes suivantes
Lisez les règles d’aplatissement et d’échappement JSON et pour comprendre comment les événements seront stockés.
Comprendre les limitations de débit de votre environnement
Découvrez sources d’événements pour ingérer des données de diffusion en continu.