Dotazy na data z Azure Time Series Insights Gen2

  • Článek
  • 3 min ke čtení

Azure Time Series Insights Gen2 umožňuje dotazování dat na události a metadata uložená v prostředí prostřednictvím rozhraní API veřejného povrchu. Tato rozhraní API používá také Azure Time Series Insights TSI.

V Azure Time Series Insights Gen2 jsou k dispozici tři primární kategorie rozhraní API:

  • Rozhraní API pro prostředí: Tato rozhraní API umožňují dotazy v samotném Azure Time Series Insights Gen2. Lze je použít ke shromáždění seznamu prostředí, ke které má volající přístup, a metadat prostředí.
  • Rozhraní API služby Time Series Model-Query (TSM-Q): Umožňuje operace vytvoření, čtení, aktualizace a odstranění (CRUD) u metadat uložených v modelu time series prostředí. Můžete je použít pro přístup k instancím, typům a hierarchii a jejich úpravám.
  • Rozhraní API time series query (TSQ): Umožňuje načítání telemetrických dat nebo dat událostí zaznamenaných od poskytovatele zdroje a umožňuje provádět výpočty a agregace dat pomocí pokročilých skalárních a agregačních funkcí.

Azure Time Series Insights Gen2 používá pro vyjádření výpočtů v proměnných časové řady formátovaný jazyk výrazů založený na řetězcíchTime Series Expression (TSX).

Azure Time Series Insights rozhraní API Gen2

Podporují se následující základní rozhraní API.

Přehled dotazů time series

Rozhraní API prostředí

  • Získat rozhraní API pro prostředí:Vrátí seznam prostředí, ke které má volající oprávnění pro přístup.
  • Získat rozhraní API pro dostupnostprostředí: Vrátí distribuci počtu událostí v časovém razítku události $ts . Toto rozhraní API pomáhá určit, jestli v prostředí existují nějaké události, vrácením počtu událostí rozdělených do časových intervalů, pokud existují.
  • Získat rozhraní API schématu událostí:Vrátí metadata schématu událostí pro daný rozsah hledání. Toto rozhraní API pomáhá načíst všechna metadata a vlastnosti dostupné ve schématu pro daný rozsah hledání.

Rozhraní API Model-Query time series (TSM-Q)

Většina těchto rozhraní API podporuje operaci dávkového spouštění, která umožňuje dávkové operace CRUD u více entit modelu Time Series:

  • Rozhraní API pronastavení modelu: Povolí GET a PATCH pro výchozí typ a název modelu prostředí.
  • Rozhraní API protypy: Povolí CRUD u typů časových řad a jejich přidružených proměnných.
  • Rozhraní API hierarchií:Povolí CRUD v hierarchiích časových řad a jejich přidružených cestách polí.
  • Rozhraní API instancí:Povolí CRUD u instancí time series a jejich přidružených polí instancí. Kromě toho rozhraní API pro instance podporuje následující operace:
    • Hledání:Načte částečný seznam hledání instancí časových řad na základě atributů instance.
    • Navrhnout:Vyhledá a navrhne částečný seznam přístupů k instancím časových řad na základě atributů instance.

Rozhraní API time series query (TSQ)

Tato rozhraní API jsou k dispozici v obou úložištích (teplé i studené) v našem řešení vícevrstvého úložiště.

  • Rozhraní API pro získáníudálostí: Umožňuje dotazování a načítání nezpracovaných událostí a přidružených časových razítek událostí, jak se zaznamenávají Azure Time Series Insights Gen2 od zdrojového poskytovatele. Toto rozhraní API umožňuje načítání nezpracovaných událostí pro dané ID časové řady a rozsah hledání. Toto rozhraní API podporuje stránkování pro načtení kompletní datové sady odpovědí pro vybraný vstup.

    Důležité

    V rámci chystaných změn pravidel zplošovánía uchytění JSON se pole uloží jako dynamický typ. Vlastnosti datové části uložené jako tento typ jsou přístupné POUZE prostřednictvím rozhraní API Pro získání událostí.

  • Get Series API:Umožňuje dotazování a načítání vypočítaných hodnot a přidružených časových razítek událostí pomocí výpočtů definovaných proměnnými u nezpracovaných událostí. Tyto proměnné je možné definovat buď v modelu time series, nebo vložené v dotazu. Toto rozhraní API podporuje stránkování pro načtení kompletní datové sady odpovědí pro vybraný vstup.

  • Rozhraní API proagregované řady: Umožňuje dotazování a načítání agregovaných hodnot a přidružených časových razítek intervalů pomocí výpočtů definovaných proměnnými u nezpracovaných událostí. Tyto proměnné je možné definovat buď v modelu time series, nebo vložené v dotazu. Toto rozhraní API podporuje stránkování pro načtení kompletní datové sady odpovědí pro vybraný vstup.

    Pro zadaný rozsah vyhledávání a interval vrátí toto rozhraní API agregovanou odpověď na interval na proměnnou pro ID časové řady. Počet intervalů v datové sadě odpovědí se počítá podle epochy (počet milisekund, které uplynuly od unixové epochy – 1. ledna 1970) a vydělí je velikostí rozpětí intervalu zadanou v dotazu.

    Časová razítka vrácená v sadě odpovědí jsou levé hranice intervalu, nikoli vzorkovaných událostí z intervalu.

Výběr typu obchodu

Výše uvedená rozhraní API se mohou spouštět pouze proti jednomu ze dvou typů úložiště (studená nebo teplá) v jednom volání. Parametry adresy URL dotazu se používají k určení typu úložiště, ve které se má dotaz spustit.

Pokud není zadaný žádný parametr, dotaz se ve výchozím nastavení spustí v cold storu. Pokud dotaz zasáhne časový rozsah překrývající se studené i teplé úložiště, doporučujeme dotaz směrovat do studeného úložiště, aby byl co nejlepší, protože teplé úložiště bude obsahovat pouze částečná data.

Průzkumník Azure Time Series Insights a konektor Power BI volá výše uvedená rozhraní API a automaticky vybere správný parametr storeType, kde je to relevantní.

Další kroky