Podporované datové typy
Poznámka
Služba Time Series Insights (TSI) už nebude po březnu 2025 podporována. Zvažte co nejdříve migraci stávajících prostředí TSI na alternativní řešení. Další informace o vyřazení a migraci najdete v naší dokumentaci.
Následující tabulka uvádí datové typy podporované Azure Time Series Insights Gen2.
| Datový typ | Popis | Příklad | Syntaxe výrazu časové řady | Název sloupce vlastnosti v Parquet |
|---|---|---|---|---|
| bool | Datový typ s jedním 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žené ve formátu UTC. Posuny časového pásma, pokud jsou správně naformátované, se použijí a pak se hodnota uloží v UTC. Další informace o vlastnosti časového razítka prostředí a posunech data a času najdete v této části. | "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" |
Pokud je "eventProcessedLocalTime" časové razítko zdroje události: $event.$ts. Pokud se jedná o jinou vlastnost JSON: $event.eventProcessedLocalTime.DateTime nebo $event['eventProcessedLocalTime'].DateTime |
eventProcessedLocalTime_datetime |
| double | 64bitové číslo s dvojitou přesností | "value": 31.0482941 |
$event.value.Double nebo $event['value'].Double |
value_double |
| long | 64bitové celé číslo se signedýmm | "value" : 31 |
$event.value.Long nebo $event['value'].Long |
value_long |
| řetězec | Textové hodnoty musí obsahovat platné kódování UTF-8. S prázdnými a null řetězci se zachází stejně. | "site": "DIM_MLGGG" |
$event.site.String nebo $event['site'].String |
site_string |
| Dynamické | Složitý (neprimitivový) typ skládající se z pole nebo kontejneru vlastností (slovníku). V současné době se jako dynamická budou ukládat pouze pole JSON s řetězci primitiv nebo pole objektů, které neobsahují ID TS nebo vlastnosti časového razítka. Přečtěte si tento článek , abyste pochopili, jak se objekty zploštěly a pole se můžou zrušit. Vlastnosti datové části uložené jako tento typ jsou přístupné pouze po výběru Explore Events v Průzkumníku Služby Time Series Insights pro zobrazení nezpracovaných událostí nebo prostřednictvím GetEvents rozhraní API pro dotazy 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
Jsou podporovány 64bitové celočíselné hodnoty, ale největší číslo, které může Azure Time Series Insights Explorer bezpečně vyjádřit, je 9 007 199 254 740 991 (2^53-1) kvůli omezením JavaScriptu. Pokud v datovém modelu pracujete s čísly nad touto hodnotou, můžete velikost zmenšit vytvořením proměnné Modelu časové řady a převodem hodnoty.
Poznámka
Typ řetězce nemůže být null:
- Výraz časové řady (TSX) vyjádřený v dotazu časové řady porovnávající hodnotu prázdného řetězce ('') s hodnotou NULL se bude chovat stejně:
$event.siteid.String = NULLje ekvivalentní hodnotě$event.siteid.String = ''. - Rozhraní API může vracet hodnoty NULL i v případě, že původní události obsahovaly prázdné řetězce.
- Pokud chcete provádět porovnání nebo vyhodnocení, nespolézejte se na hodnoty NULL ve sloupcích řetězců , 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ého typu. 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 při definování výrazů proměnných modelu časové řady ve voláních rozhraní API by se měla použít funkce coalesce( ).
Azure Time Series Insights Explorer nabízí způsob, jak automaticky sloučit samostatné sloupce stejné vlastnosti zařízení. V následujícím příkladu senzor odešle PresentValue vlastnost, která může být long i double. Pokud se chcete dotazovat na všechny uložené hodnoty (bez ohledu na datový typ) PresentValue vlastnosti, zvolte PresentValue (Double | Long) a sloupce se pro vás spojí.
Objekty a pole
Jako součást datové části události můžete odesílat komplexní typy, jako jsou objekty a pole. Vnořené objekty se zploštějí a pole se buď uloží jako dynamic , nebo zploštějí, aby vzniklo více událostí v závislosti na konfiguraci prostředí a tvaru JSON. Další informace najdete v článku o pravidlech zploštělování a úniku dat JSON.
Další kroky
Přečtěte si pravidla zploštělování a uvozování json , abyste pochopili, jak se události budou ukládat.
Vysvětlení omezení propustnosti vašeho prostředí
Přečtěte si o zdrojích událostí , které ingestují streamovaná data.