Ondersteunde gegevenstypen
Notitie
De Time Series Insights-service wordt op 7 juli 2024 buiten gebruik gesteld. Overweeg om bestaande omgevingen zo snel mogelijk naar alternatieve oplossingen te migreren. Ga naar onze documentatievoor meer informatie over de veroudering en migratie.
De volgende tabel bevat de gegevenstypen die worden ondersteund door Azure Time Series Insights Gen2
| Gegevenstype | Beschrijving | Voorbeeld | Tijdreeksuitdrukkingen-syntaxis | Kolomnaam van eigenschap in Parquet |
|---|---|---|---|---|
| bool | Een gegevenstype met een van de volgende twee statussen: true of false. |
"isQuestionable" : true |
$event.isQuestionable.Bool of $event['isQuestionable'].Bool |
isQuestionable_bool |
| datum en tijd | Vertegenwoordigt een moment in de tijd, meestal uitgedrukt als een datum en tijd van de dag. Uitgedrukt in ISO 8601 indeling. Datum/tijd-eigenschappen worden altijd opgeslagen in UTC-formaat. Tijdzone-offsets, indien correct opgemaakt, worden toegepast en vervolgens wordt de waarde opgeslagen in UTC. Zie dit gedeelte voor meer informatie over de tijdstempel-eigenschap van de omgeving en datum/tijd-offsets | "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" |
Als 'eventProcessedLocalTime' de tijdstempel van de gebeurtenisbron is: $event.$ts. Als dit een andere JSON-eigenschap is: $event.eventProcessedLocalTime.DateTime of $event['eventProcessedLocalTime'].DateTime |
eventProcessedLocalTime_datetime |
| dubbele | Een 64-bits getal met dubbele precisie | "value": 31.0482941 |
$event.value.Double of $event['value'].Double |
value_double |
| lange | Een ondertekend 64-bits geheel getal | "value" : 31 |
$event.value.Long of $event['value'].Long |
value_long |
| tekenreeks | Tekstwaarden moeten bestaan uit geldige UTF-8. Null- en lege tekenreeksen worden hetzelfde behandeld. | "site": "DIM_MLGGG" |
$event.site.String of $event['site'].String |
site_string |
| dynamische | Een complex (niet-primitief) type dat bestaat uit een matrix of eigenschapszak (woordenlijst). Momenteel worden alleen geserialiseerde JSON-arrays van primitieve waarden of arrays van objecten die de TS-ID of tijdstempels niet bevatten als dynamisch opgeslagen. Lees dit artikel om te begrijpen hoe objecten worden afgevlakt en matrices mogelijk worden uitgeschreven. Eigenschappen van payload die zijn opgeslagen als dit type, zijn alleen toegankelijk door Explore Events te selecteren in Time Series Insights Explorer om onbewerkte gebeurtenissen weer te geven of via de GetEvents Query-API voor parsering aan clientzijde. |
"values": "[197, 194, 189, 188]" |
Het verwijzen naar dynamische typen in een Time Series-expressie wordt nog niet ondersteund | values_dynamic |
Notitie
64 bits gehele getallen worden ondersteund, maar het grootste getal dat de Azure Time Series Insights Explorer veilig kan uitdrukken, is 9.007.199.254.740.991 (2^53-1) vanwege JavaScript-beperkingen. Als u hierboven met getallen in uw gegevensmodel werkt, kunt u de grootte verkleinen door een Time Series-modelvariabele te maken en de waarde te converteren.
Notitie
Stringtype staat geen nulwaarden toe:
- Een Time Series Expression (TSX) uitgedrukt in een Time Series-query waarbij de waarde van een lege tekenreeks ('') wordt vergeleken met NULL, zal hetzelfde gedrag vertonen:
$event.siteid.String = NULLis equivalent aan$event.siteid.String = ''. - De API kan NULL- waarden retourneren, zelfs als de oorspronkelijke gebeurtenissen lege tekenreeksen bevatten.
- Vertrouw niet op NULL- waarden in tekstkolommen om vergelijkingen of evaluaties uit te voeren; behandel ze op dezelfde manier als lege tekenreeksen.
Gemengde gegevenstypen verzenden
Uw Azure Time Series Insights Gen2-omgeving is sterk getypt. Als apparaten of tags gegevens van verschillende typen voor een apparaateigenschap verzenden, worden waarden opgeslagen in twee gescheiden kolommen en moet de functie coalesce() worden gebruikt bij het definiëren van de expressies voor tijdreeksmodelvariabelen in API-aanroepen.
Azure Time Series Insights Explorer biedt een manier om de afzonderlijke kolommen van dezelfde apparaateigenschap automatisch samen te koppelen. In het onderstaande voorbeeld verzendt de sensor een PresentValue-eigenschap die zowel een long als een double kan zijn. Als u query's wilt uitvoeren op alle opgeslagen waarden (ongeacht het gegevenstype) van de eigenschap PresentValue, kiest u PresentValue (Double | Long) en worden de kolommen aan u gekoppeld.
Objecten en arrays
U kunt complexe typen, zoals objecten en matrices, verzenden als onderdeel van de nettolading van uw gebeurtenis. Geneste objecten worden afgevlakt en matrices worden opgeslagen als dynamic of afgevlakt om meerdere gebeurtenissen te produceren, afhankelijk van uw omgevingsconfiguratie en JSON-shape. Om meer te weten te komen, leest u over de JSON-afvlakkings- en escaperegels
Volgende stappen
Lees de JSON-afvlakken en escaperegels om te begrijpen hoe gebeurtenissen worden opgeslagen.
Begrijp de doorvoerbeperkingen van uw omgeving
Meer informatie over gebeurtenisbronnen voor het opnemen van streaminggegevens.