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 vyřazení 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 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ženy ve formátu UTC. Posuny časových pásem, pokud jsou správně formátované, se použijí a hodnoty uložené v UTC. Další informace o vlastnosti časového razítka prostředí a posunech data a času | "eventProcessedLocalTime": "2020-03-20T09:03:32.8301668Z" |
Pokud eventProcessedLocalTime je časové razítko zdroje událostí: $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 signedm | "value" : 31 |
$event.value.Long nebo $event['value'].Long |
value_long |
| string | Textové hodnoty, musí se skládat z platné UTF-8. Se stejnými řetězci se zachází s hodnotou Null a prázdnými řetězci. | "site": "DIM_MLGGG" |
$event.site.String nebo $event['site'].String |
site_string |
| dynamic | 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. V tomto článku se dozvíte, jak budou objekty zploštěny a pole se můžou zrušit. Vlastnosti datové části uložené jako tento typ jsou přístupné jenom tak Explore Events , že v Průzkumníku služby Time Series Insights vyberete zobrazení nezpracovaných událostí nebo prostřednictvím GetEvents rozhraní API pro dotazy pro analýzu 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:
Typ řetězce není nullable:
- Výraz časové řady (TSX) vyjádřený v dotazu časové řady, který porovnává hodnotu prázdného řetězce (') s hodnotou 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.
- Nevyužít závislost na hodnotách NULL ve sloupcích String k porovnání nebo vyhodnocení, považovat je za 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 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 služby Azure Time Series Insights 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 nebo Double. Pokud se chcete dotazovat na všechny uložené hodnoty (bez ohledu na datový typ) PresentValue vlastnosti, 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 se zploštějí a pole budou buď uložena jako dynamic nebo zploštěna, aby vzniklo více událostí v závislosti na konfiguraci prostředí a tvaru JSON. Další informace o zploštěnách a pravidlech zapouzdření JSON
Další kroky
Přečtěte si pravidla zploštění a eskapace JSON, abyste pochopili, jak budou události uloženy.
Seznamte se se zdroji událostí pro příjem streamovaných dat.