Sdílet prostřednictvím

Dotazování dat z Azure Time Series Insights Gen2

  • Článek

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.

Azure Time Series Insights Gen2 umožňuje dotazování událostí a metadat uložených v prostředí prostřednictvím veřejných API. Tato rozhraní API také používá Průzkumník TSI služby 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 přímo v 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 metadata prostředí.
  • rozhraní API Model-Query časových řad (TSM-Q): Umožňuje operace vytváření, čtení, aktualizace a odstraňování (CRUD) na metadatech uložených v modelu časové řady prostředí. Ty se dají použít pro přístup k instancím, typům a hierarchiím a jejich úpravám.
  • rozhraní API TSQ (Time Series Query): Umožňuje načítat telemetrická data nebo data událostí, která jsou zaznamenána od poskytovatele zdroje, a umožňuje provádět výkonné 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á bohatý jazyk výrazů založený na řetězci, Time Series Expression (TSX), pro vyjádření výpočtů v proměnných časových řadách.

Přehled rozhraní API Azure Time Series Insights Gen2

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

Přehled dotazů na časové řady

Rozhraní API prostředí

  • Get Environments API: Vrátí seznam prostředí, ke kterým má volající oprávnění přistupovat.
  • Rozhraní API pro dostupnost prostředí: Vrátí distribuci počtu událostí podle $tsčasového razítka udá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 existují.
  • Rozhraní API pro získání schématu událostí: Vrátí metadata schématu událostí pro dané rozsahy hledání. Toto rozhraní API pomáhá načíst všechna metadata a vlastnosti dostupné ve schématu pro dané rozsahy hledání.

Rozhraní API časových řad Model-Query (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 pro nastavení modelu: Povolit GET a PATCH pro výchozí typ a název modelu prostředí.
  • API typů: Umožňuje CRUD pro typy časových řad a jejich přidružené proměnné.
  • Rozhraní API pro hierarchie: Umožňuje operace CRUD (vytváření, čtení, aktualizaci, mazání) u hierarchií časových řad a jejich přidružených cest k polím.
  • rozhraní API instancí: Povolí CRUD u instancí časové řady a jejich přidružených polí. Kromě toho rozhraní API instancí podporuje následující operace:
    • Hledání: Načte částečný seznam výsledků z vyhledávání časových řad instancí na základě atributů instancí.
    • Navrhnout: Vyhledá a navrhne částečný seznam zásahů 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 k dispozici v rámci našeho vícevrstvého úložného řešení v obou úložištích (Teplém a Studeném).

  • API pro získávání událostí: Umožňuje dotazování a načítání nezpracovaných událostí a souvisejících časových razítek, které jsou zaznamenávány ve službě Azure Time Series Insights Gen2 od poskytovatele zdrojových dat. Toto rozhraní API umožňuje načtení nezpracovaných událostí pro dané ID časové řady a časový úsek 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ění a uvozování JSONbudou pole uložena 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 dotazovat a načítat vypočítané hodnoty a přidružené časové razítka událostí pomocí výpočtů definovaných proměnnými ze základních událostí. Tyto proměnné lze definovat buď v modelu časové řady, nebo v dotazu. Toto rozhraní API podporuje stránkování pro načtení úplné datové sady odpovědí pro vybraný vstup.

  • API řady agregátů: Umožňuje dotazovat se a načítat agregované hodnoty a přidružená časová razítka intervalů pomocí výpočtů, které jsou definovány proměnnými u surových událostí. Tyto proměnné lze definovat buď v modelu časové řady, nebo 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ěď pro každou proměnnou v každém intervalu pro ID časové řady. Počet intervalů v datové sadě odpovědí se určuje počítáním epochových tiků (počet milisekund, které uplynuly od Unixové epochy – 1. ledna 1970) a jejich vydělením velikostí rozpětí intervalu zadanou v dotazu.

    Časová razítka vrácená v sadě odpovědí se týkají levých hranic intervalů, nikoli vzorkovaných událostí z intervalu.

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

Výše uvedená rozhraní API se můžou spouštět pouze u jednoho ze dvou typů úložiště (Studená nebo Teplá) v jednom volání. Parametry dotazu adresy URL se používají k určení typu úložiště, na kterém by se měl dotaz provést.

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

Průzkumník služby Azure Time Series Insights a konektor Power BI provádějí volání na výše uvedená rozhraní API a v případě potřeby automaticky vyberou správný parametr storeType.

Další kroky