Dotazy na data z Azure Time Series Insights Gen2

  • Článek

Poznámka

Služba Time Series Insights (TSI) už nebude po březnu 2025 podporována. Zvažte migraci stávajících prostředí TSI na alternativní řešení co nejdříve. Další informace o vyřazení a migraci najdete v naší dokumentaci.

Azure Time Series Insights Gen2 umožňuje dotazování dat na události a metadata uložená v prostředí prostřednictvím veřejných rozhraní API pro surface. Tato rozhraní API jsou také používána průzkumníkem TSI Azure Time Series Insights.

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

  • Rozhraní API prostředí: Tato rozhraní API umožňují dotazy na samotné prostředí Azure Time Series Insights Gen2. Můžete je použít ke shromáždění seznamu prostředí, ke kterému má volající přístup, a metadat prostředí.
  • Rozhraní API time series Model-Query (TSM-Q): Umožňuje operace crud (vytvoření, čtení, aktualizace a odstranění) s metadaty uloženými v modelu časových řad prostředí. Můžete je použít k přístupu k instancím, typům a hierarchii a jejich úpravám.
  • Rozhraní API time series query (TSQ): Umožňuje načítat telemetrická data nebo data událostí, jak jsou zaznamenána od zdrojového poskytovatele, 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ých řad bohatý jazyk výrazů založený na řetězcích, Time Series Expression (TSX).

Přehled rozhraní API Azure Time Series Insights Gen2

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

Přehled dotazů time series

Rozhraní API prostředí

  • Rozhraní API Get Environment: Vrátí seznam prostředí, ke kterým má volající oprávnění k přístupu.
  • Rozhraní GET Environment Availability API: Vrátí rozdělení počtu událostí na časové razítko $tsudálosti . Toto rozhraní API pomáhá určit, jestli v prostředí existují nějaké události, a to vrácením počtu událostí rozdělených do časových intervalů, pokud nějaké 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 time series Model-Query (TSM-Q)

Většina z těchto rozhraní API podporuje operaci dávkového spuštění, která umožňuje dávkové operace CRUD pro více entit modelu časových řad:

  • Rozhraní API nastavení modelu: Povolí funkce GET a PATCH pro výchozí typ a název modelu prostředí.
  • Rozhraní API typů: 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 pro instance: Povolí CRUD pro instance časových řad a jejich přidružená pole instancí. Rozhraní API služby Instances navíc podporuje následující operace:
    • Hledání: Načte částečný seznam přístupů při hledání instancí časových řad na základě atributů instance.
    • Navrhnout: Vyhledá a navrhne částečný seznam přístupů při hledání instancí časových řad na základě atributů instance.

Rozhraní API pro dotazy časových řad (TSQ)

Tato rozhraní API jsou dostupná v obou obchodech (teplé i studené) v našem řešení s vícevrstvým úložištěm.

  • 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 jsou zaznamenány v Azure Time Series Insights Gen2 od poskytovatele zdroje. 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í úplné datové sady odpovědí pro vybraný vstup.

    Důležité

    V rámci nadcházejících změn pravidel zploštělování a úniku kódu 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í počí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 časových řad, nebo je můžete zadat přímo v dotazu. Toto rozhraní API podporuje stránkování pro načtení úplné datové sady odpovědí pro vybraný vstup.

  • Rozhraní API agregovaných řad: Umožňuje dotazovat a načítat agregované hodnoty a přidružená intervalová časová razítka použitím výpočtů definovaných proměnnými u nezpracovaných událostí. Tyto proměnné je možné definovat buď v modelu časových řad, nebo je můžete zadat přímo v dotazu. Toto rozhraní API podporuje stránkování pro načtení úplné datové sady odpovědí pro vybraný vstup.

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

    Časová razítka vrácená v sadě odpovědí jsou ohraničena levým intervalem, nikoli vzorkovanými událostmi z intervalu.

Výběr typu úložiště

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

Pokud není zadán žádný parametr, dotaz se ve výchozím nastavení spustí v studeném úložišti. Pokud dotaz pokrývá časový rozsah překrývající se studené a teplé úložiště, doporučujeme ho směrovat do studeného úložiště, protože teplé úložiště bude obsahovat jenom částečná data.

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

Další kroky