Podporované datové typy
Poznámka
Služba Time Series Insights bude vyřazena 7. července 2024. Zvažte migraci stávajících prostředí na alternativní řešení co nejdříve. Další informace o ukončení podpory a migraci najdete v naší dokumentaci .
Následující tabulka uvádí datové typy podporované službou Azure Time Series Insights Gen2.
| Datový typ | Popis | Příklad | Syntaxe výrazů časové řady | Název sloupce vlastností formátu Parquet |
|---|---|---|---|---|
| bool | Datový typ má jeden ze dvou stavů: true nebo false. |
"isQuestionable" : true |
$event.isQuestionable.Bool nebo $event['isQuestionable'].Bool |
isQuestionable_bool |
| datetime | Představuje okamžik v čase, obvykle vyjádřený jako datum a čas dne. Vyjádřeno ve formátu ISO 8601. Vlastnosti data a času jsou vždy uloženy ve formátu UTC. Časová pásma, pokud jsou správně naformátovaná, budou použita a hodnota poté uložena v UTC. Podívejte se na tuto sekci pro více informací o vlastnosti časového razítka prostředí a o posunu data a času. | "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" |
Pokud je "eventProcessedLocalTime" časovým razítkem zdroje události: $event.$ts. Pokud se jedná o jinou vlastnost JSON: $event.eventProcessedLocalTime.DateTime nebo $event['eventProcessedLocalTime'].DateTime |
eventProcessedLocalTime_datetime |
| dvojitý | 64bitové číslo s dvojitou přesností | "value": 31.0482941 |
$event.value.Double nebo $event['value'].Double |
value_double |
| dlouhé | Podepsané 64bitové celé číslo | "value" : 31 |
$event.value.Long nebo $event['value'].Long |
value_long |
| řetězec | Textové hodnoty musí být ve formátu platného UTF-8. Řetězce s hodnotou null a prázdné řetězce jsou považovány za totožné. | "site": "DIM_MLGGG" |
$event.site.String nebo $event['site'].String |
site_string |
| dynamické | Komplexní (ne primitivní) typ skládající se z pole nebo kontejneru vlastností (slovník). V současné době se jako dynamická uloží pouze pole JSON s primitivními vlastnostmi nebo poli objektů, které neobsahují ID TS nebo vlastnosti časového razítka. Přečtěte si tento článek, abyste pochopili, jak budou objekty zploštěny a pole rozvinuta. Vlastnosti datové části uložené jako tento typ jsou přístupné pouze výběrem Explore Events v Time Series Insights Explorer pro zobrazení nezpracovaných událostí, nebo prostřednictvím GetEvents Query API pro parsování na straně klienta. |
"values": "[197, 194, 189, 188]" |
Odkazování na dynamické typy ve výrazu časové řady se zatím nepodporuje. | values_dynamic |
Poznámka
Podporují se 64bitové celočíselné hodnoty, ale největší číslo, které může Průzkumník služby Azure Time Series Insights bezpečně vyjádřit, je 9 007 199 254 740 991 (2^53–1) kvůli omezením JavaScriptu. Pokud pracujete s čísly v datovém modelu výše, můžete velikost zmenšit tak, že vytvoříte proměnnou modelu časové řady a převedete hodnotu.
Poznámka
Řetězec není typ nulovatelný:
- Výraz časové řady (TSX) vyjádřený v dotazu časové řady porovnávání hodnoty prázdného řetězce ('') s null se bude chovat stejně:
$event.siteid.String = NULLje ekvivalentní$event.siteid.String = ''. - Rozhraní API může vrátit hodnoty NULL, i když původní události obsahovaly prázdné řetězce.
- Nespoléhejte se na hodnoty NULL ve sloupcích String k porovnávání nebo vyhodnocování, zacházejte s nimi stejně jako s prázdnými řetězci.
Odesílání smíšených datových typů
Vaše prostředí Azure Time Series Insights Gen2 je silně typizované. Pokud zařízení nebo značky odesílají data různých typů pro vlastnost zařízení, hodnoty se uloží do dvou oddělených sloupců a funkce coalesce() by se měla použít při definování výrazů proměnných modelu časové řady ve voláních rozhraní API.
Průzkumník Azure Time Series Insights nabízí způsob, jak automaticky spojit samostatné sloupce stejné vlastnosti zařízení. V následujícím příkladu senzor odešle vlastnost PresentValue, která může být typu Long nebo Double. Pokud chcete dotazovat na všechny uložené hodnoty (bez ohledu na datový typ) vlastnosti PresentValue, zvolte PresentValue (Double | Long) a sloupce budou sloučeny za vás.
Objekty a pole
Jako součást datové části události můžete posílat složité typy, jako jsou objekty a pole. Vnořené objekty budou zploštěny a pole budou buď uložena jako dynamic, nebo zploštěna tak, aby vznikla více událostí v závislosti na konfiguraci prostředí a tvaru JSON. Další informace si přečtěte o pravidlech zploštění a escapingu JSON
Další kroky
Přečtěte si pravidla zploštění a eskapace JSON, abyste pochopili, jak budou události uloženy.
Vysvětlení omezení propustnosti prostředí
Zjistěte více o zdrojích událostí pro zpracování streamovaných dat.