Gegevens uit Azure Time Series Insights Gen2 opvragen

  • Artikel

Notitie

De Tsi-service (Time Series Insights) wordt na maart 2025 niet meer ondersteund. Overweeg om bestaande TSI-omgevingen zo snel mogelijk te migreren naar alternatieve oplossingen. Raadpleeg onze documentatie voor meer informatie over de afschaffing en migratie.

Azure Time Series Insights Gen2 maakt het uitvoeren van gegevensquery's mogelijk op gebeurtenissen en metagegevens die zijn opgeslagen in de omgeving via openbare surface-API's. 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 kunt u query's uitvoeren op de Azure Time Series Insights Gen2-omgeving zelf. Deze kunnen worden gebruikt voor het verzamelen van de lijst met omgevingen waar de aanroeper toegang toe heeft en omgevingsmetagegevens.
  • Time Series Model-Query(TSM-Q)-API's: maakt het maken, lezen, bijwerken en verwijderen (CRUD)-bewerkingen mogelijk voor 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-API's (TSQ): maakt het mogelijk om telemetrie- of gebeurtenisgegevens op te halen wanneer deze worden vastgelegd bij de bronprovider en om krachtige berekeningen en aggregaties voor de gegevens mogelijk te maken met behulp van geavanceerde scalaire en statistische functies.

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-variabelen.

Overzicht van 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 omgevingen ophalen: retourneert de lijst met omgevingen waartoe de aanroeper toegang heeft.
  • Api voor beschikbaarheid van omgevingen ophalen: retourneert de distributie van het aantal gebeurtenissen over de tijdstempel van $tsde gebeurtenis . Met deze API kunt u bepalen of er gebeurtenissen in de omgeving zijn door het aantal gebeurtenissen te retourneren dat is onderverdeeld in tijdsintervallen, indien aanwezig.
  • Gebeurtenisschema-API ophalen: retourneert de metagegevens van het gebeurtenisschema voor een bepaald zoekbereik. Deze API helpt bij het ophalen van alle metagegevens en eigenschappen die beschikbaar zijn in het schema voor het opgegeven zoekbereik.

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

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

  • API voor modelinstellingen: hiermee schakelt u GET en PATCH in op het standaardtype en de modelnaam van de omgeving.
  • Typen-API: hiermee schakelt u CRUD in voor tijdreekstypen en de bijbehorende variabelen.
  • Api voor hiërarchieën: hiermee schakelt u CRUD in op tijdreekshiërarchieën en de bijbehorende veldpaden.
  • Instances-API: hiermee schakelt u CRUD in op Time Series-exemplaren en de bijbehorende exemplaarvelden. Daarnaast ondersteunt de Instances-API de volgende bewerkingen:
    • Zoeken: haalt een gedeeltelijke lijst met treffers op bij het zoeken naar tijdreeksexemplaren op basis van exemplaarkenmerken.
    • Suggesties: hiermee wordt een gedeeltelijke lijst met treffers op zoek naar tijdreeksexemplaren op basis van exemplaarkenmerken gezocht en voorgesteld.

TSQ-API's (Time Series Query)

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

  • Gebeurtenissen-API ophalen: hiermee schakelt u query's op en ophalen van onbewerkte gebeurtenissen en de bijbehorende gebeurtenistijdstempels inschakelen wanneer deze worden vastgelegd in Azure Time Series Insights Gen2 van de bronprovider. Met deze API kunnen onbewerkte gebeurtenissen worden opgehaald voor een bepaalde tijdreeks-id en zoekbereik. Deze API ondersteunt paginering om de volledige antwoordgegevensset voor de geselecteerde invoer op te halen.

    Belangrijk

    Als onderdeel van de aanstaande wijzigingen in JSON-afvlakkings- en escaperegels worden matrices opgeslagen als dynamisch type. Nettoladingeigenschappen die als dit type zijn opgeslagen, zijn ALLEEN toegankelijk via de API Gebeurtenissen ophalen.

  • Reeks-API ophalen: hiermee kunt u query's uitvoeren en ophalen van berekende waarden en de bijbehorende gebeurtenistijdstempels 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 antwoordgegevensset voor de geselecteerde invoer op te halen.

  • Api voor de statistische reeks: hiermee kunt u query's uitvoeren en ophalen van geaggregeerde waarden en de bijbehorende intervaltijdstempels 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 antwoordgegevensset voor de geselecteerde invoer op te halen.

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

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

Winkeltype selecteren

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

Als er geen parameter is opgegeven, wordt de query standaard uitgevoerd op Cold Store. Als een query een tijdsbereik overspant dat zowel het koude als het warme archief overlapt, is het raadzaam om de query om te sturen naar de koude opslag voor de beste ervaring, omdat warm opslag slechts gedeeltelijke gegevens bevat.

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

Volgende stappen