Sdílet prostřednictvím

Dotazy na data 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í dat na události a metadata uložená v prostředí prostřednictvím veřejných rozhraní API pro surface. 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 v samotném 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 TSM-Q (Time Series Model-Query): Umožňuje vytvářet, číst, aktualizovat a odstraňovat operace (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 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á pro vyjádření výpočtů v proměnných časové řady bohatý jazyk výrazů založený na řetězcích, výraz time series (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í

  • Získat rozhraní API pro prostředí: Vrátí seznam prostředí, ke kterým má volající oprávnění pro přístup.
  • Získat rozhraní API pro dostupnost prostředí: Vrátí distribuci počtu událostí v časovém razítku $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 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 TSM-Q (Time Series Model-Query)

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: Povolí funkci GET a PATCH ve výchozím typu a název modelu prostředí.
  • Rozhraní API typů: Umožňuje CRUD u typů časových řad a jejich přidružených proměnných.
  • Rozhraní API hierarchií: Umožňuje CRUD u hierarchií časových řad a jejich přidružených cest polí.
  • Rozhraní API instancí: Umožňuje cruD u instancí časové řady a jejich přidružených polí instance. Kromě toho rozhraní API instancí 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 time series (TSQ)

Tato rozhraní API jsou k dispozici v rámci našich vícevrstvých úložných řešení v obchodech (Teplá i Studená).

  • Rozhraní API pro získání událostí: Umožňuje dotazování a načtení nezpracovaných událostí a přidružených časových razítek událostí, které se zaznamenávají ve službě Azure Time Series Insights Gen2 od poskytovatele zdroje. Toto rozhraní API umožňuje načtení 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ění a odvozování JSON budou pole uložena jako dynamický typ. Vlastnosti datové části uložené jako tento typ jsou přístupné pouze prostřednictvím rozhraní API Get Events.

  • Rozhraní API pro získání řady: Umožňuje dotazování a načtení 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é 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.

  • Rozhraní API agregované ř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é 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.

    V případě zadaného rozsahu a intervalu 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 počítá počítáním epochových klíštěí (počet milisekund, které uplynuly od unixového epochy – 1. ledna 1970) a vydělí se intervaly velikostí intervalu zadanou v dotazu.

    Časová razítka vrácená v sadě odpovědí jsou hranice levého intervalu, 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 adresy URL dotazu slouží k určení typu úložiště, na kterém se má 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 volá výše uvedená rozhraní API a automaticky vybere správný parametr storeType, pokud je to relevantní.

Další kroky

  • Přečtěte si další informace o různých proměnných, které lze definovat v modelu časové řady.
  • Přečtěte si další informace o dotazování dat z Průzkumníka služby Azure Time Series Insights.