Dela via


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.

Explorer auto coalesce

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