Datatyper som stöds
Kommentar
Time Series Insights-tjänsten dras tillbaka den 7 juli 2024. Överväg att migrera befintliga 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 | Syntax för Tidsserieuttryck | Egenskapskolumnnamn i Parquet |
---|---|---|---|---|
Bool | 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ötidsstämpelegenskapen 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 |
dubbel | Ett 64-bitars nummer med dubbel precision | "value": 31.0482941 |
$event.value.Double eller $event['value'].Double |
value_double |
lång | 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 egenskapsväska (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 om du vill veta 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 |
Kommentar
64-bitars heltalsvärden stöds, men det största talet som Azure Time Series Insights Explorer säkert kan uttrycka ä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.
Kommentar
Strängtypen kan inte vara 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 ('') mot NULL fungerar på samma sätt:
$event.siteid.String = NULL
motsvarar$event.siteid.String = ''
. - API:et kan returnera NULL-värden även om ursprungliga händelser innehåller tomma strängar.
- Var 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 skriven. Om enheter eller taggar skickar data av olika typer för en enhetsegenskap lagras värden i två avgränsade kolumner och funktionen coalesce() ska användas när du definierar dina tidsseriemodellvariabeluttryck i API-anrop.
Azure Time Series Insights Explorer erbjuder ett sätt att automatiskt sammansejsa 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 som 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 generera flera händelser beroende på din miljökonfiguration och JSON-form. Läs mer om reglerna för JSON-utplattande och undantag
Nästa steg
Läs reglerna för JSON-utplattande och undantag för att förstå hur händelser kommer att lagras.
Lär dig mer om händelsekällor för att mata in strömmande data.