Adatok lekérése az Azure Time Series Insights Gen2-ből
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.
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
$ts
alapjá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:
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
- További információ az idősormodellben definiálható különböző változókról.
- További információ arról, hogyan kérdezhet le adatokat az Azure Time Series Insights Explorerből.