Datatyper som stöds
Anteckning
Tjänsten Time Series Insights (TSI) stöds inte längre efter mars 2025. Överväg att migrera befintliga TSI-miljöer till alternativa lösningar så snart som möjligt. Mer information om utfasning och migrering finns i vår dokumentation.
I följande tabell visas de datatyper som stöds av Azure Time Series Insights Gen2
| Datatyp | Beskrivning | Exempel | Tidsserieuttryckssyntax | Egenskapskolumnnamn i Parquet |
|---|---|---|---|---|
| boolesk | En datatyp som har ett av två tillstånd: true eller false. |
"isQuestionable" : true |
$event.isQuestionable.Bool eller $event['isQuestionable'].Bool |
isQuestionable_bool |
| datetime | Representerar ett ögonblick i tiden, vanligtvis uttryckt som datum och tid på dagen. Uttryckt i ISO 8601-format . Datetime-egenskaper lagras alltid i UTC-format. Tidszonsförskjutningar, om de är korrekt formaterade, tillämpas och sedan det värde som lagras i UTC. Mer information om miljöns tidsstämpelegenskap och datetime-förskjutningar finns i det här avsnittet | "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" |
Om "eventProcessedLocalTime" är tidsstämpeln för händelsekällan: $event.$ts. Om det är en annan JSON-egenskap: $event.eventProcessedLocalTime.DateTime eller $event['eventProcessedLocalTime'].DateTime |
eventProcessedLocalTime_datetime |
| double | Ett 64-bitarsnummer med dubbel precision | "value": 31.0482941 |
$event.value.Double eller $event['value'].Double |
value_double |
| long | Ett signerat 64-bitars heltal | "value" : 31 |
$event.value.Long eller $event['value'].Long |
value_long |
| sträng | Textvärden måste bestå av giltiga UTF-8. Null- och tomma strängar behandlas på samma sätt. | "site": "DIM_MLGGG" |
$event.site.String eller $event['site'].String |
site_string |
| Dynamisk | En komplex (icke-primitiv) typ som består av antingen en matris eller egenskapsuppsättning (ordlista). För närvarande lagras endast strängifierade JSON-matriser med primitiver eller matriser med objekt som inte innehåller TS-ID:t eller tidsstämpelegenskapen (ies) som dynamiska. Läs den här artikeln för att förstå hur objekt kommer att plattas ut och matriser kan avregistreras. Nyttolastegenskaper som lagras som den här typen är endast tillgängliga genom att Explore Events välja i Time Series Insights Explorer för att visa råhändelser eller via fråge-API:et GetEvents för parsning på klientsidan. |
"values": "[197, 194, 189, 188]" |
Det finns ännu inte stöd för att referera till dynamiska typer i ett Time Series-uttryck | values_dynamic |
Anteckning
64-bitars heltalsvärden stöds, men det största talet som Azure Time Series Insights Explorer kan uttrycka säkert är 9 007 199 254 740 991 (2^53–1) på grund av JavaScript-begränsningar. Om du arbetar med tal i datamodellen ovan kan du minska storleken genom att skapa en Time Series Model-variabel och konvertera värdet.
Anteckning
Strängtypen kan inte ha värdet null:
- Ett Time Series-uttryck (TSX) som uttrycks i en Time Series-fråga som jämför värdet för en tom sträng ('') med NULL fungerar på samma sätt:
$event.siteid.String = NULLmotsvarar$event.siteid.String = ''. - API:et kan returnera NULL-värden även om ursprungliga händelser innehåller tomma strängar.
- Ta inte beroende av NULL-värden i Strängkolumner för att göra jämförelser eller utvärderingar, behandla dem på samma sätt som tomma strängar.
Skicka blandade datatyper
Din Azure Time Series Insights Gen2-miljö är starkt typifierad. Om enheter eller taggar skickar data av olika typer för en enhetsegenskap lagras värdena i två avgränsade kolumner och funktionen coalesce() ska användas när du definierar dina Time Series Model Variable-uttryck i API-anrop.
Med Azure Time Series Insights Explorer kan du automatiskt slå samman de separata kolumnerna i samma enhetsegenskap. I exemplet nedan skickar sensorn en PresentValue egenskap som kan vara både lång eller dubbel. Om du vill köra frågor mot alla lagrade värden (oavsett datatyp) för PresentValue egenskapen väljer du PresentValue (Double | Long) och kolumnerna kommer att sammanslagas åt dig.
Objekt och matriser
Du kan skicka komplexa typer, till exempel objekt och matriser som en del av händelsenyttolasten. Kapslade objekt plattas ut och matriser lagras antingen som dynamic eller plattas ut för att skapa flera händelser beroende på din miljökonfiguration och JSON-form. Läs mer om reglerna för att platta ut och fly från JSON
Nästa steg
Läs reglerna för JSON-utplattning och undantag för att förstå hur händelser kommer att lagras.
Förstå din miljös dataflödesbegränsningar
Läs mer om händelsekällor för att mata in strömmande data.