Datatyper som stöds
Notera
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, kommer att tillämpas och värdet lagras sedan i UTC. Mer information om miljötidstämpelns egenskap och datumtidsfö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 |
| dubbla | 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 icke-primitiv komplex typ som består av antingen en matris eller egenskapssamling (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 avvecklas. Nyttolastegenskaper som lagras som den här typen är endast tillgängliga genom att välja Explore Events i Time Series Insights Explorer för att visa råhändelser eller via GetEvents Query API 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 |
Note
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-modellvariabel och konvertera värdet.
Not
Sträng typ är inte nullbar:
- Ett Time Series-uttryck (TSX) uttryckt i en Time Series-fråga som jämför värdet av en tom sträng ('') med NULL kommer att fungera på samma sätt:
$event.siteid.String = NULLär ekvivalent med$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 String kolumner 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 slå samman de separata kolumnerna för samma enhetsattribut. I exemplet nedan skickar sensorn en PresentValue-egenskap som kan vara både en Long eller en Double. Om du vill köra frågor mot alla lagrade värden (oavsett datatyp) för egenskapen PresentValue väljer du PresentValue (Double | Long) så sammansejsas kolumnerna å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 skapa flera händelser beroende på din miljökonfiguration och JSON-form. Mer information finns i JSON-regler för utplattande och undantag
Nästa steg
Läs reglerna för utjämning och undantag i JSON för att förstå hur händelser ska lagras.
Förstå miljöns överföringskapacitetsbegränsningar
Lär dig mer om händelsekällor för att mata in strömmande data.