Sdílet prostřednictvím


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 = NULL je 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.

Automatické shodování Průzkumníka

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.

  • Vysvětlení omezení propustnosti vašeho prostředí

  • Seznamte se se zdroji událostí pro příjem streamovaných dat.