Gegevens uit Azure Time Series Insights Gen2 opvragen

Azure Time Series Insights Gen2 kunt u query's uitvoeren op gebeurtenissen en metagegevens die zijn opgeslagen in de omgeving via API's van het openbare oppervlak. Deze API's worden ook gebruikt door de Azure Time Series Insights TSI Explorer.

Er zijn drie primaire API-categorieën beschikbaar in Azure Time Series Insights Gen2:

  • Omgevings-API's: met deze API's kunnen query's worden Azure Time Series Insights gen2-omgeving zelf. Deze kunnen worden gebruikt voor het verzamelen van de lijst met omgevingen die de aanroeper toegang heeft tot metagegevens van de omgeving en .
  • Time Series Model-Query (TSM-Q)-API's: hiermee kunt u CRUD-bewerkingen (maken, lezen, bijwerken en verwijderen) uitvoeren op metagegevens die zijn opgeslagen in het Time Series Model van de omgeving. Deze kunnen worden gebruikt om de exemplaren, typen en hiërarchieën te openen en te bewerken.
  • Time Series Query (TSQ)-API's: hiermee kunt u telemetrie- of gebeurtenisgegevens ophalen zoals deze zijn vastgelegd bij de bronprovider en kunnen performante berekeningen en aggregaties op de gegevens worden uitgevoerd met behulp van geavanceerde scalaire en aggregatiefuncties.

Azure Time Series Insights Gen2 maakt gebruik van een uitgebreide expressietaal op basis van tekenreeksen, Time Series Expression (TSX), voor het uitdrukken van berekeningen in Time Series Variables.

overzicht Azure Time Series Insights Gen2-API's

De volgende kern-API's worden ondersteund.

Overzicht van Time Series-query's

Omgevings-API's

  • Api voor het op halenvan omgevingen: retourneert de lijst met omgevingen die de aanroeper mag openen.
  • Beschikbaarheids-API voor omgevingen krijgen:retourneert de distributie van het aantal gebeurtenissen over de tijdstempel van de $ts gebeurtenis. Met deze API kunt u bepalen of er gebeurtenissen in de omgeving zijn door het aantal gebeurtenissen te retourneren dat is opgesplitst in tijdsintervallen, indien aanwezig.
  • Api voor gebeurtenisschema's ophalen: retourneert de metagegevens van het gebeurtenisschema voor een bepaalde zoekactie. Deze API helpt bij het ophalen van alle metagegevens en eigenschappen die beschikbaar zijn in het schema voor de opgegeven zoekperiode.

Time Series Model-Query (TSM-Q) API's

De meeste van deze API's ondersteunen batchuitvoeringsbewerkingen om batch CRUD-bewerkingen op meerdere Time Series Model-entiteiten mogelijk te maken:

  • API voor modelinstellingen:hiermee schakelt u GET en PATCH in voor het standaardtype en de modelnaam van de omgeving.
  • Api voor typen:hiermee schakelt u CRUD in voor tijdreekstypen en de bijbehorende variabelen.
  • Hiërarchieën-API:hiermee schakelt u CRUD in op Tijdreekshiërarchieën en de bijbehorende veldpaden.
  • Api voor exemplaren:hiermee schakelt u CRUD in voor Time Series-exemplaren en de bijbehorende instantievelden. Daarnaast ondersteunt de API instances de volgende bewerkingen:
    • Zoeken:haalt een gedeeltelijke lijst met treffers op bij het zoeken naar tijdreeksen op basis van instantiekenmerken.
    • Voorstellen:zoekt en stelt een gedeeltelijke lijst met treffers voor bij het zoeken naar tijdreeksen op basis van instantiekenmerken.

TSQ-API's (Time Series Query)

Deze API's zijn beschikbaar in beide winkels (Warm en Koud) in onze meerlaagse opslagoplossing.

  • Api voor gebeurtenissen ophalen:hiermee schakelt u het opvragen en ophalen van onbewerkte gebeurtenissen en de bijbehorende tijdstempels van gebeurtenissen in zoals deze worden vastgelegd in Azure Time Series Insights Gen2 van de bronprovider. Met deze API kunnen onbewerkte gebeurtenissen voor een bepaalde tijdreeks-id en zoektijdspanne worden opgehaald. Deze API ondersteunt paginering om de volledige antwoordset voor de geselecteerde invoer op te halen.

    Belangrijk

    Als onderdeel van de aanstaande wijzigingen in JSON-regelsvoor plat maken en escapen, worden matrices opgeslagen als dynamisch type. Nettoladingeigenschappen die zijn opgeslagen als dit type, zijn ALLEEN toegankelijk via de API Gebeurtenissen downloaden.

  • Series-API ophalen:hiermee kunt u berekende waarden en de bijbehorende tijdstempels voor gebeurtenissen opvragen en ophalen door berekeningen toe te passen die zijn gedefinieerd door variabelen op onbewerkte gebeurtenissen. Deze variabelen kunnen worden gedefinieerd in het Time Series-model of inline worden opgegeven in de query. Deze API ondersteunt paginering om de volledige antwoordset voor de geselecteerde invoer op te halen.

  • Aggregate Series API:hiermee kunt u geaggregeerde waarden en de bijbehorende intervaltijdstempels opvragen en ophalen door berekeningen toe te passen die zijn gedefinieerd door variabelen op onbewerkte gebeurtenissen. Deze variabelen kunnen worden gedefinieerd in het Time Series-model of inline worden opgegeven in de query. Deze API ondersteunt paginering om de volledige antwoordset voor de geselecteerde invoer op te halen.

    Voor een opgegeven zoektijdsinterval retourneert deze API een geaggregeerd antwoord per interval per variabele voor een tijdreeks-id. Het aantal intervallen in de antwoordset wordt berekend door epoche-tikken te tellen (het aantal milliseconden dat is verstreken sinds Unix-epoche - 1 januari 1970) en de tikken te delen door de intervalgrootte die is opgegeven in de query.

    De tijdstempels die in de antwoordset worden geretourneerd, zijn van de grenzen van het linkerinterval, niet van de voorbeeldgebeurtenissen van het interval.

Winkeltype selecteren

De bovenstaande API's kunnen slechts in één aanroep worden uitgevoerd op een van de twee opslagtypen (Koud of Warm). Query-URL-parameters worden gebruikt om het winkeltype op te geven waarin de query moet worden uitgevoerd.

Als er geen parameter is opgegeven, wordt de query standaard uitgevoerd in Koude opslag. Als een query een tijdsbereik bespant dat zowel koude als warme opslag overlapt, is het raadzaam om de query voor de beste ervaring door te geven naar een koude opslag, omdat Warm-opslag slechts gedeeltelijke gegevens bevat.

De Azure Time Series Insights Explorer en Power BI Connector maken aanroepen naar de bovenstaande API's en selecteren automatisch de juiste parameter storeType, indien relevant.

Volgende stappen

  • Lees meer over verschillende variabelen die kunnen worden gedefinieerd in het Time Series-model.
  • Lees meer over het opvragen van gegevens uit Azure Time Series Insights Explorer.