Adatok lekérése az Azure Time Series Insights Gen2-ből

  • Cikk

Megjegyzés

A Time Series Insights (TSI) szolgáltatás 2025 márciusa után már nem támogatott. Fontolja meg a meglévő TSI-környezetek migrálását alternatív megoldásokba a lehető leghamarabb. Az elavulással és a migrálással kapcsolatos további információkért tekintse meg dokumentációnkat.

Azure Time Series Insights Gen2 lehetővé teszi a környezetben tárolt események és metaadatok nyilvános surface API-kkal történő lekérdezését. Ezeket az API-kat az Azure Time Series Insights TSI Explorer is használja.

Három elsődleges API-kategória érhető el Azure Time Series Insights Gen2-ben:

  • Környezeti API-k: Ezek az API-k magukban a Azure Time Series Insights Gen2-környezetben engedélyezik a lekérdezéseket. Ezekkel összegyűjtheti azoknak a környezeteknek a listáját, amelyhez a hívó hozzáfér, valamint a környezeti metaadatokat.
  • Time Series Model-Query (TSM-Q) API-k: Engedélyezi a környezet idősormodelljében tárolt metaadatokon végzett létrehozási, olvasási, frissítési és törlési (CRUD) műveleteket. Ezekkel elérheti és szerkesztheti a példányokat, a típusokat és a hierarchiákat.
  • Idősoros lekérdezési (TSQ) API-k: Lehetővé teszi a telemetriai vagy eseményadatok lekérését a forrásszolgáltatótól rögzítve, és fejlett skaláris és összesítő függvények használatával teszi lehetővé a teljesítményt nyújtó számítások és összesítések használatát az adatokon.

Azure Time Series Insights Gen2 a Time Series Expression (TSX) gazdag sztringalapú kifejezésnyelvet használ a time series változók számításainak kifejezéséhez.

Azure Time Series Insights Gen2 API-k áttekintése

A következő alapvető API-k támogatottak.

Idősoros lekérdezés áttekintése

Környezeti API-k

  • Környezetek API lekérése: Azoknak a környezeteknek a listáját adja vissza, amelyek eléréséhez a hívó jogosult.
  • Környezetek rendelkezésre állási API lekérése: Az eseményszám eloszlását adja vissza az esemény időbélyege $tsalapján. Ez az API segít meghatározni, hogy vannak-e események a környezetben, ha az események számát időintervallumokra bontva adja vissza, ha vannak ilyenek.
  • Eseményséma API lekérése: Egy adott keresési tartomány eseményséma-metaadatait adja vissza. Ez az API segít lekérni az adott keresési tartomány sémájában elérhető összes metaadatot és tulajdonságot.

Time Series Model-Query (TSM-Q) API-k

Ezen API-k többsége támogatja a kötegelt végrehajtási műveletet a kötegelt CRUD-műveletek több idősormodell-entitáson való engedélyezéséhez:

  • Modellbeállítások API: Engedélyezi a GET és a PATCH beállítást az alapértelmezett típus és a környezet modellneve alapján.
  • Types API: Engedélyezi a CRUD-t az idősortípusokon és a hozzájuk tartozó változókon.
  • Hierarchies API: Engedélyezi a CRUD-t az idősor-hierarchiákon és a hozzájuk tartozó mezőútvonalakon.
  • Instances API: Engedélyezi a CRUD-t az idősorpéldányokon és a hozzájuk tartozó példánymezőkön. Emellett a Instances API a következő műveleteket támogatja:
    • Keresés: A példányattribútumok alapján lekéri az idősorpéldányok keresésére vonatkozó találatok részleges listáját.
    • Javaslat: Az idősorpéldányok példányattribútumok alapján történő keresésére vonatkozó találatok részleges listáját keresi és javasolja.

Idősoros lekérdezési (TSQ) API-k

Ezek az API-k mindkét üzletben elérhetők (meleg és hideg) a többrétegű tárolási megoldásban.

  • Események lekérése API: Engedélyezi a nyers események és a kapcsolódó eseményidőbélyegek lekérdezését és lekérését, mivel azok a forrásszolgáltatótól Azure Time Series Insights Gen2-ben vannak rögzítve. Ez az API lehetővé teszi a nyers események lekérését egy adott idősor-azonosítóhoz és keresési tartományhoz. Ez az API támogatja a lapozást a kiválasztott bemenet teljes válaszadatkészletének lekéréséhez.

    Fontos

    A JSON-simítási és -feloldási szabályok közelgő módosításainak részeként a tömbök dinamikus típusként lesznek tárolva. Az ilyen típusú hasznos adattulajdonságok csak az Események lekérése API-val érhetők el.

  • Adatsor API lekérése: Lehetővé teszi a számított értékek és a kapcsolódó eseményidőbélyegek lekérdezését és lekérését a változók által a nyers eseményeken definiált számítások alkalmazásával. Ezek a változók definiálhatók az idősormodellben vagy a lekérdezésben beágyazott módon. Ez az API támogatja a lapozást a kiválasztott bemenet teljes válaszadatkészletének lekéréséhez.

  • Aggregátumsorozat API: Lehetővé teszi az összesített értékek és a kapcsolódó intervallum-időbélyegek lekérdezését és lekérését a változók által a nyers eseményeken definiált számítások alkalmazásával. Ezek a változók definiálhatók az idősormodellben vagy a lekérdezésben beágyazott módon. Ez az API támogatja a lapozást a kiválasztott bemenet teljes válaszadatkészletének lekéréséhez.

    Adott keresési időtartam és intervallum esetén ez az API változónként összesített választ ad vissza egy idősor-azonosítóhoz. A válaszadatkészletben lévő intervallumok számát a rendszer a korszakjelek (unix epoch óta eltelt ezredmásodpercek száma – 1970. január 1. óta eltelt idő) megszámolásával és a lekérdezésben megadott intervallumtartomány méretével osztja el a osztásokat.

    A válaszkészletben visszaadott időbélyegek a bal intervallumhatárok, nem pedig az intervallumból vett mintaesemények.

Áruháztípus kiválasztása

A fenti API-k csak a két tárolási típus (Hideg vagy Meleg) egyikén hajthatók végre egyetlen hívásban. A lekérdezési URL-paraméterekkel megadhatja, hogy a lekérdezésnek milyen tárolótípust kell végrehajtania.

Ha nincs megadva paraméter, a lekérdezés alapértelmezés szerint a Cold Store-ban lesz végrehajtva. Ha egy lekérdezés egy olyan időtartományra terjed ki, amely átfedésben van a Hideg és a Meleg tárolóval is, javasoljuk, hogy a lehető legjobb élmény érdekében iránya a lekérdezést a Hidegtárba, mivel a Meleg tároló csak részleges adatokat fog tartalmazni.

A Azure Time Series Insights Explorer és a Power BI Connector hívásokat kezdeményez a fenti API-khoz, és automatikusan kiválasztja a megfelelő storeType paramétert, ha szükséges.

Következő lépések