Unterstützte Datentypen
Anmerkung
Der Time Series Insights-Dienst wird am 7. Juli 2024 eingestellt. Erwägen Sie, vorhandene Umgebungen so schnell wie möglich zu alternativen Lösungen zu migrieren. Weitere Informationen zur Veralterung und zur Migration finden Sie in unserer -Dokumentation.
In der folgenden Tabelle sind die Datentypen aufgeführt, die von Azure Time Series Insights Gen2 unterstützt werden.
| Datentyp | Beschreibung | Beispiel | Zeitausdruck-Syntax für Zeitreihen | Spaltenname der Eigenschaft in Parquet |
|---|---|---|---|---|
| bool | Ein Datentyp mit einem von zwei Zuständen: true oder false. |
"isQuestionable" : true |
$event.isQuestionable.Bool oder $event['isQuestionable'].Bool |
isQuestionable_bool |
| Datum und Uhrzeit | Stellt einen Zeitpunkt dar, der in der Regel als Datum und Uhrzeit ausgedrückt wird. Ausgedrückt im ISO 8601-Format . Datetime-Eigenschaften werden immer im UTC-Format gespeichert. Zeitzonenverschiebungen werden, wenn sie richtig formatiert sind, angewendet und dann werden die Werte in UTC gespeichert. Weitere Informationen zur Umgebungszeitstempeleigenschaft und Datum-Zeit-Offsets finden Sie in diesem Abschnitt. | "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" |
Wenn "eventProcessedLocalTime" der Zeitstempel der Ereignisquelle ist: $event.$ts. Wenn es sich um eine andere JSON-Eigenschaft handelt: $event.eventProcessedLocalTime.DateTime oder $event['eventProcessedLocalTime'].DateTime |
eventProcessedLocalTime_datetime |
| doppelt | Eine 64-Bit-Zahl mit doppelter Genauigkeit | "value": 31.0482941 |
$event.value.Double oder $event['value'].Double |
value_double |
| lange | Eine signierte 64-Bit-Ganzzahl | "value" : 31 |
$event.value.Long oder $event['value'].Long |
value_long |
| Zeichenfolge | Textwerte müssen aus gültigem UTF-8 bestehen. Null- und leere Zeichenfolgen werden gleich behandelt. | "site": "DIM_MLGGG" |
$event.site.String oder $event['site'].String |
site_string |
| dynamisch | Ein komplexer (nicht-primitiver) Typ, der aus einem Array oder einer Eigenschaftensammlung (Wörterbuch) besteht. Derzeit werden nur in Zeichenform konvertierte JSON-Arrays von Grundelementen oder Arrays von Objekten als dynamisch gespeichert, die weder die TS-ID noch die Timestamp-Eigenschaft(en) enthalten. Lesen Sie diesen Artikel, um zu verstehen, wie Objekte abgeflacht werden und Arrays möglicherweise entrollt werden. Auf Nutzlast-Eigenschaften, die vom Typ gespeichert sind, kann nur durch Auswahl von Explore Events im Time Series Insights Explorer zum Anzeigen von Rohdatenereignissen oder über die Abfrage-API GetEvents für die clientseitige Analyse zugegriffen werden. |
"values": "[197, 194, 189, 188]" |
Das Verweisen auf dynamische Typen in einem Zeitreihenausdruck wird noch nicht unterstützt. | values_dynamic |
Anmerkung
64-Bit-Ganzzahlwerte werden unterstützt, aber die größte Zahl, die der Azure Time Series Insights-Explorer sicher ausdrücken kann, ist 9.007.199.254.740.991 (2^53-1) aufgrund von JavaScript-Einschränkungen. Wenn Sie mit Zahlen in Ihrem Datenmodell darüber arbeiten, können Sie die Größe verringern, indem Sie eine Zeitreihenmodellvariable erstellen und den Wert konvertieren.
Anmerkung
String--Typ ist nicht nullwertfähig:
- Ein Zeitreihenausdruck (TIME Series Expression, TSX) in einer Zeitreihenabfrage ausgedrückt vergleicht den Wert einer leeren Zeichenfolge ('') mit NULL- verhält sich auf die gleiche Weise:
$event.siteid.String = NULLentspricht$event.siteid.String = ''. - Die API gibt möglicherweise NULL-Werte zurück, auch wenn ursprüngliche Ereignisse leere Zeichenfolgen enthielten.
- Verlassen Sie sich nicht auf NULL--Werte in Zeichenfolgenspalten für Vergleiche oder Auswertungen, sondern behandeln Sie sie genauso wie leere Zeichenfolgen.
Senden gemischter Datentypen
Ihre Azure Time Series Insights Gen2-Umgebung ist stark typisiert. Wenn Geräte oder Tags Daten verschiedener Typen für eine Geräteeigenschaft senden, werden Werte in zwei getrennten Spalten gespeichert, und die coalesce()-Funktion sollten verwendet werden, wenn Sie Ihre Ausdrücke der Zeitreihenmodellvariable in API-Aufrufen definieren.
Der Azure Time Series Insights-Explorer bietet eine Möglichkeit, die separaten Spalten derselben Geräteeigenschaft automatisch zu zusammenführen. Im folgenden Beispiel sendet der Sensor eine PresentValue-Eigenschaft, die sowohl ein Long als auch ein Double sein kann. Um alle gespeicherten Werte (unabhängig vom Datentyp) der PresentValue-Eigenschaft abzufragen, wählen Sie PresentValue (Double | Long) aus, und die Spalten werden für Sie zusammengeführt.
Objekte und Arrays
Sie können komplexe Typen wie Objekte und Arrays als Teil der Ereignisnutzlast senden. Geschachtelte Objekte werden abgeflacht, und Arrays werden entweder als dynamic gespeichert oder abgeflacht, um je nach Konfiguration Ihrer Umgebung und JSON-Struktur mehrere Ereignisse zu erzeugen. Weitere Informationen zu den JSON-Flattening- und Escaping-Regeln
Nächste Schritte
Lesen Sie die JSON-Flattening- und Escaperegeln, um zu verstehen, wie Ereignisse gespeichert werden.
Verstehen Sie die Durchsatzbeschränkungen Ihrer Umgebung
Erfahren Sie mehr über Ereignisquellen zum Erfassen von Streamingdaten.