Obsługiwane typy danych:

Uwaga

Usługa Time Series Insights zostanie wycofana 7 lipca 2024 r. Rozważ migrację istniejących środowisk do alternatywnych rozwiązań tak szybko, jak to możliwe. Aby uzyskać więcej informacji na temat wycofywania i migracji, odwiedź naszą dokumentację.

W poniższej tabeli wymieniono typy danych obsługiwane przez usługę Azure Time Series Insights Gen2

Typ danych	opis	Przykład	Składnia wyrażenia szeregów czasowych	Nazwa kolumny właściwości w Parquet
bool	Typ danych o jednym z dwóch stanów: true lub false.	"isQuestionable" : true	$event.isQuestionable.Bool lub $event['isQuestionable'].Bool	isQuestionable_bool
data/godzina	Reprezentuje moment w czasie, zwykle wyrażony jako data i godzina dnia. Wyrażone w formacie ISO 8601 . Właściwości daty/godziny są zawsze przechowywane w formacie UTC. Przesunięcia strefy czasowej, jeśli zostały poprawnie sformatowane, zostaną zastosowane, a następnie wartości przechowywane w formacie UTC. Zobacz tę sekcję, aby uzyskać więcej informacji na temat właściwości znacznika czasu środowiska i przesunięcia daty/godziny	"eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z"	Jeśli element "eventProcessedLocalTime" to sygnatura czasowa źródła zdarzeń: $event.$ts. Jeśli jest to inna właściwość JSON: $event.eventProcessedLocalTime.DateTime lub $event['eventProcessedLocalTime'].DateTime	eventProcessedLocalTime_datetime
double	Liczba 64-bitowa o podwójnej precyzji	"value": 31.0482941	$event.value.Double lub $event['value'].Double	value_double
long	Podpisana liczba całkowita 64-bitowa	"value" : 31	$event.value.Long lub $event['value'].Long	value_long
string	Wartości tekstowe muszą składać się z prawidłowego utF-8. Ciągi o wartości null i puste są traktowane tak samo.	"site": "DIM_MLGGG"	$event.site.String lub $event['site'].String	site_string
dynamic	Typ złożony (nie-pierwotny) składający się z tablicy lub torby właściwości (słownika). Obecnie tylko ciągowane tablice JSON pierwotnych lub tablic obiektów, które nie zawierają identyfikatora TS lub właściwości znacznika czasu(ies) będą przechowywane jako dynamiczne. Przeczytaj ten artykuł , aby dowiedzieć się, jak obiekty będą spłaszczone, a tablice mogą być wyrejestrowane. Właściwości ładunku przechowywane jako ten typ są dostępne tylko przez wybranie Explore Events w Eksploratorze usługi Time Series Insights w celu wyświetlenia nieprzetworzonych zdarzeń lub za pośrednictwem interfejsu GetEvents API zapytań na potrzeby analizowania po stronie klienta.	"values": "[197, 194, 189, 188]"	Odwoływanie się do typów dynamicznych w wyrażeniu szeregów czasowych nie jest jeszcze obsługiwane	values_dynamic

Uwaga

Obsługiwane są 64-bitowe wartości całkowite, ale największa liczba, którą eksplorator usługi Azure Time Series Insights może bezpiecznie wyrazić, to 9 007 199 254 740 991 (2^53-1) ze względu na ograniczenia języka JavaScript. Jeśli pracujesz z liczbami w modelu danych powyżej, możesz zmniejszyć rozmiar, tworząc zmienną modelu szeregów czasowych i konwertując wartość.

Uwaga

Typ ciągu nie może zawierać wartości null:

• Wyrażenie szeregów czasowych (TSX) wyrażone w zapytaniu szeregów czasowych porównujące wartość pustego ciągu ('') względem wartości NULL zachowuje się w taki sam sposób: $event.siteid.String = NULL jest równoważne $event.siteid.String = ''.
• Interfejs API może zwracać wartości NULL , nawet jeśli oryginalne zdarzenia zawierały puste ciągi.
• Nie należy przyjmować zależności od wartości NULL w kolumnach Ciąg , aby wykonywać porównania lub oceny, traktuj je tak samo jak puste ciągi.

Wysyłanie mieszanych typów danych

Środowisko usługi Azure Time Series Insights Gen2 jest silnie typizowane. Jeśli urządzenia lub tagi wysyłają dane różnych typów dla właściwości urządzenia, wartości będą przechowywane w dwóch osobnych kolumnach, a funkcja coalesce() powinna być używana podczas definiowania wyrażeń zmiennych modelu szeregów czasowych w wywołaniach interfejsu API.

Eksplorator usługi Azure Time Series Insights umożliwia automatyczne łączenie oddzielnych kolumn tej samej właściwości urządzenia. W poniższym przykładzie czujnik wysyła PresentValue właściwość, która może być zarówno długa, jak i podwójna. Aby wykonać zapytanie względem wszystkich przechowywanych wartości (niezależnie od typu danych) PresentValue właściwości, wybierz PresentValue (Double | Long) i kolumny zostaną połączyć.

Obiekty i tablice

Możesz wysyłać złożone typy, takie jak obiekty i tablice w ramach ładunku zdarzenia. Zagnieżdżone obiekty zostaną spłaszczone, a tablice będą przechowywane jako dynamic lub spłaszczone w celu wygenerowania wielu zdarzeń w zależności od konfiguracji środowiska i kształtu JSON. Aby dowiedzieć się więcej na temat spłaszczania i ucieczki w formacie JSON

Następne kroki

• Przeczytaj reguły spłaszczania i ucieczki w formacie JSON, aby dowiedzieć się, jak będą przechowywane zdarzenia.

• Omówienie ograniczeń przepływności środowiska

• Dowiedz się więcej o źródłach zdarzeń w celu pozyskiwania danych przesyłanych strumieniowo.