Delen via

Gegevens uit Azure Time Series Insights Gen2 opvragen

  • Artikel

Notitie

De Time Series Insights-service wordt op 7 juli 2024 buiten gebruik gesteld. Overweeg om bestaande omgevingen zo snel mogelijk naar alternatieve oplossingen te migreren. Raadpleeg onze documentatie voor meer informatie over de afschaffing en migratie.

Met Azure Time Series Insights Gen2 kunnen gegevens worden opgeslagen in 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 kunnen query's worden uitgevoerd in de Azure Time Series Insights Gen2-omgeving zelf. Deze kunnen worden gebruikt om de lijst met omgevingen te verzamelen die de aanroeper toegang heeft tot en omgevingsmetagegevens.
  • Time Series Model-Query-API's (TSM-Q): maakt het maken, lezen, bijwerken en verwijderen (CRUD) 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.
  • TSQ-API's (Time Series Query): hiermee kunnen telemetriegegevens of gebeurtenisgegevens worden opgehaald wanneer deze worden vastgelegd vanuit de bronprovider en kunnen krachtige berekeningen en aggregaties op de gegevens worden uitgevoerd 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 Api's van Azure Time Series Insights Gen2

De volgende kern-API's worden ondersteund.

Overzicht van Time Series-query's

Omgevings-API's

  • Omgevingen-API ophalen: retourneert de lijst met omgevingen waartoe de aanroeper is gemachtigd.
  • Beschikbaarheids-API voor omgevingen ophalen: retourneert de distributie van het aantal gebeurtenissen over de tijdstempel $tsvan gebeurtenissen. Met deze API kunt u bepalen of er gebeurtenissen in de omgeving zijn door het aantal gebeurtenissen te retourneren dat is opgesplitst in intervallen van tijd, 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.

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

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

  • 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 op tijdreekstypen en de bijbehorende variabelen.
  • Hiërarchie-API: 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 instantiekenmerken.
    • Suggesties: Hiermee wordt een gedeeltelijke lijst met treffers bij het zoeken naar tijdreeksexemplaren op basis van exemplaarkenmerken voorgesteld.

TSQ-API's (Time Series Query)

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

  • Gebeurtenissen-API ophalen: hiermee kunt u query's uitvoeren en ophalen van onbewerkte gebeurtenissen en de bijbehorende tijdstempels voor gebeurtenissen wanneer ze worden vastgelegd in Azure Time Series Insights Gen2 van de bronprovider. Met deze API kunt u onbewerkte gebeurtenissen ophalen voor een bepaalde Time Series-id en zoekspanne. Deze API ondersteunt paginering om de volledige antwoordgegevensset voor de geselecteerde invoer op te halen.

    Belangrijk

    Als onderdeel van de aanstaande wijzigingen in JSON-afvlakken en escaperegels, worden matrices opgeslagen als dynamisch type. Eigenschappen van nettolading die zijn opgeslagen als dit type, zijn ALLEEN toegankelijk via de GET Events-API.

  • Get Series-API: hiermee kunt u query's uitvoeren en ophalen van berekende waarden en de bijbehorende tijdstempels voor gebeurtenissen door berekeningen toe te passen die zijn gedefinieerd door variabelen voor 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.

  • Statistische reeks-API: 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 voor 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 zoekperiode 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 epoch-maatstreepjes te tellen (het aantal milliseconden dat is verstreken sinds de Unix-epoch - 1 januari 1970) en het delen van de maatstreepjes op basis van de intervalperiode die is opgegeven in de query.

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

Winkeltype selecteren

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

Als er geen parameter is opgegeven, wordt de query standaard uitgevoerd in Cold Store. Als een query een tijdsbereik omvat dat zowel koude als warme opslag overlapt, is het raadzaam om de query naar een koude opslag te routeren voor de beste ervaring, omdat warme opslag alleen gedeeltelijke gegevens bevat.

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

Volgende stappen