Adatok lekérése az Azure Time Series Insights Gen2-ből
Feljegyzés
A Time Series Elemzések szolgáltatás 2024. július 7-én megszűnik. Fontolja meg a meglévő 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.
Az Azure Time Series Elemzések Gen2 nyilvános felületi API-kkal teszi lehetővé a környezetben tárolt események és metaadatok lekérdezését. Ezeket az API-kat az Azure Time Series Elemzések TSI Explorer is használja.
Három elsődleges API-kategória érhető el az Azure Time Series Elemzések Gen2-ben:
- Környezeti API-k: Ezek az API-k az Azure Time Series Elemzések Gen2-környezetben engedélyezik a lekérdezéseket. Ezek felhasználhatók azon környezetek listájának összegyűjtésére, amelyhez a hívó hozzáfér, és a környezet metaadatai.
- Time Series Model-Query (TSM-Q) API-k: Engedélyezi a környezet Idősorozat-modelljé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.
- Time Series Query (TSQ) API-k: Lehetővé teszi a telemetriai vagy eseményadatok lekérését a forrásszolgáltatótól, és speciális skaláris és összesítő függvények használatával teszi lehetővé a teljesítménybeli számítások és összesítések végrehajtását az adatokon.
Az Azure Time Series Elemzések 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.
Az Azure Time Series Elemzések Gen2 API-k áttekintése
Az alábbi alapvető API-k támogatottak.
Környezeti API-k
- A Környezetek API lekérése: A hívó által engedélyezett környezetek listáját adja vissza.
- A 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ötegvégrehajtási műveletet a kötegelt CRUD-műveletek több idősormodell-entitáson való engedélyezéséhez:
- Modell Gépház API: Engedélyezi a GET és a PATCH beállítást az alapértelmezett típus és a környezet modellneve alapján.
- Típusok API: Engedélyezi a CRUD-t az idősorokon és a hozzájuk tartozó változókon.
- Hierarchies API: Engedélyezi a CRUD idősoros hierarchiáit és a hozzájuk tartozó mezőútvonalakat.
- Instances API: Engedélyezi a CRUD-t az idősorpéldányokon és a hozzájuk tartozó példánymezőkön. A Instances API emellett a következő műveleteket is támogatja:
Time Series Query (TSQ) API-k
Ezek az API-k mindkét üzletben elérhetők (meleg és hideg) többrétegű tárolási megoldásunkban.
Események API lekérése: Engedélyezi a nyers események és a kapcsolódó eseményidőbélyegek lekérdezését és lekérését az Azure Time Series Elemzések Gen2-ben a forrásszolgáltatótól. 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 -menekülé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 az idősormodellben vagy a lekérdezésben beágyazottan is meghatározhatók. 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 az idősormodellben vagy a lekérdezésben beágyazottan is meghatározhatók. Ez az API támogatja a lapozást a kiválasztott bemenet teljes válaszadatkészletének lekéréséhez.
Egy megadott keresési időtartam és intervallum esetében ez az API egy idősor-azonosító változónként összesített válaszát adja vissza változónként. A válaszadatkészlet időközeinek számát a rendszer a korszakjelek (unix epoch óta eltelt ezredmásodpercek száma – 1970. január 1.) megszámolásával számítja ki, és a lekérdezésben megadott intervallum-span mérettel osztja el a kullancsokat.
A válaszkészletben visszaadott időbélyegek a bal intervallumhatárok, nem pedig az intervallumból vett mintául szolgáló események.
Áruháztípus kiválasztása
A fenti API-k csak a két tárolási típus (hideg vagy meleg) egyikével hajthatók végre egyetlen hívásban. A lekérdezési URL-paraméterek segítségével adhatja meg, hogy a lekérdezésnek milyen tárolótípuson kell futnia.
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 hideg és egy meleg tárolót átfedő időtartományra terjed ki, javasoljuk, hogy a legjobb élmény érdekében a lekérdezést a Cold Store-ba irányítsa, mivel a Meleg tároló csak részleges adatokat tartalmaz.
Az Azure Time Series Elemzések Explorer és a Power BI Csatlakozás or 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 Elemzések Explorerből.