Unterstützte Datentypen

  • Artikel

Hinweis

Der TSI-Dienst (Time Series Insights) wird nach März 2025 nicht mehr unterstützt. Erwägen Sie, vorhandene TSI-Umgebungen so bald wie möglich zu alternativen Lösungen zu migrieren. Weitere Informationen zur Einstellung und Migration finden Sie in unserer Dokumentation.

In der folgenden Tabelle sind die von Azure Time Series Insights Gen2 unterstützten Datentypen aufgeführt.

Datentyp BESCHREIBUNG Beispiel Syntax des Zeitreihenausdrucks Spaltenname für Eigenschaft in Parquet
bool Ein Datentyp, der diese beiden Zustände aufweisen kann: true oder false. "isQuestionable" : true $event.isQuestionable.Bool oder $event['isQuestionable'].Bool isQuestionable_bool
datetime Stellt einen Zeitpunkt dar, der üblicherweise als Datum und Uhrzeit ausgedrückt wird. Wird im Format ISO 8601 ausgedrückt. Datetime-Eigenschaften werden immer im UTC-Format gespeichert. Zeitzonenverschiebungen werden, sofern korrekt formatiert, angewendet, und der resultierende Wert wird in UTC gespeichert. Weitere Informationen über die Zeitstempel-Eigenschaft einer Umgebung und die Datetime-Verschiebungen finden Sie in diesem Abschnitt. "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" Wenn „eventProcessedLocalTime“ der Zeitstempel für die Ereignisquelle ist: $event.$ts. Wenn es sich um eine andere JSON-Eigenschaft handelt: $event.eventProcessedLocalTime.DateTime oder $event['eventProcessedLocalTime'].DateTime eventProcessedLocalTime_datetime
double Eine 64-Bit-Zahl mit doppelter Genauigkeit "value": 31.0482941 $event.value.Double oder $event['value'].Double value_double
long Eine 64-Bit-Ganzzahl mit Vorzeichen "value" : 31 $event.value.Long oder $event['value'].Long value_long
string Textwerte müssen aus gültigen Zeichen in UTF-8 bestehen. NULL und leere Zeichenfolgen werden gleich behandelt. "site": "DIM_MLGGG" $event.site.String oder $event['site'].String site_string
dynamic Ein komplexer (nicht primitiver) Typ, der entweder aus einem Array oder einer Eigenschaftensammlung (Wörterbuch) besteht. Derzeit werden nur JSON-Arrays, die Primitive als Zeichenfolgen enthalten, oder Arrays von Objekten, die nicht die TS-ID oder Zeitstempel-Eigenschaft(en) enthalten, mit dem Typ „dynamic“ gespeichert. Lesen Sie diesen Artikel, um zu erfahren, wie Objekte vereinfacht und Arrays möglicherweise aufgelöst werden. Auf Payloadeigenschaften, die in Form dieses Typs gespeichert werden, kann nur zugegriffen werden, indem zur Anzeige von unformatierten Ereignissen Explore Events im Time Series Insights-Explorer ausgewählt wird. Eine weitere Möglichkeit für den Zugriff ist die GetEvents-Abfrage-API für eine clientseitige Analyse. "values": "[197, 194, 189, 188]" Verweise auf dynamische Typen in einem Zeitreihenausdruck werden noch nicht unterstützt. values_dynamic

Hinweis

64-Bit-Ganzzahlwerte werden unterstützt. Die größte Zahl, die vom Azure Time Series Insights-Explorer sicher ausgedrückt werden kann, ist aufgrund von JavaScript-Einschränkungen folgende: 9.007.199.254.740.991 (2^53-1). Wenn Sie in Ihrem Datenmodell mit größeren Zahlen arbeiten, können Sie die Größe verringern, indem Sie eine Zeitreihenmodellvariable erstellen und den Wert konvertieren.

Hinweis

Der Typ Zeichenfolge lässt keine NULL-Werte zu:

  • Ein in einer Zeitreihenabfrage ausgedrückter Zeitreihenausdruck (Time Series Expression, TSX), der den Wert einer leeren Zeichenfolge ('') mit NULL vergleicht, weist das gleiche Verhalten auf: entspricht .
  • Die API gibt möglicherweise NULL-Werte zurück, auch wenn ursprüngliche Ereignisse leere Zeichenfolgen enthielten.
  • Verwenden Sie keine Abhängigkeit von NULL-Werten in Spalten vom Typ Zeichenfolge, um Vergleiche oder Auswertungen durchzuführen. Behandeln Sie sie wie leere Zeichenfolgen.

Senden von gemischten Datentypen

Ihre Azure Time Series Insights Gen2-Umgebung ist stark typisiert. Wenn Geräte oder Tags Daten unterschiedlichen Typs für eine Geräteeigenschaft senden, werden die Werte in zwei verschiedenen Spalten gespeichert. Zudem sollten Sie die coalesce()-Funktion verwenden, wenn Sie die Ausdrücke Ihrer Zeitreihenmodellvariablen in API-Aufrufen definieren.

Der Azure Time Series Insights-Explorer bietet eine Möglichkeit zum automatischen Zusammenfügen der verschiedenen Spalten einer Geräteeigenschaft. Im folgenden Beispiel sendet der Sensor eine PresentValue-Eigenschaft, die sowohl vom Typ „Long“ als auch vom Typ „Double“ sein kann. Wählen Sie PresentValue (Double | Long) aus, um alle gespeicherten Werte der PresentValue-Eigenschaft (unabhängig vom Datentyp) abzufragen. Daraufhin werden die Spalten zusammengefügt.

Explorer: automatisches Zusammenfügen

Objekte und Arrays

Sie können komplexe Typen, z. B. Objekte und Arrays, als Teil ihrer Ereignisnutzlast senden. Geschachtelte Objekte werden vereinfacht, und Arrays werden entweder als dynamic gespeichert oder vereinfacht, um abhängig von Ihrer Umgebungskonfiguration und JSON-Form mehrere Ereignisse zu erzeugen. Weitere Informationen finden Sie unter JSON-Vereinfachungs- und -Escaperegeln.

Nächste Schritte