Skicka frågor till data från Azure Time Series Insights Gen2

  • Artikel
  • 3 minuter för att läsa

Azure Time Series Insights Gen2 möjliggör datafrågor om händelser och metadata som lagras i miljön via offentliga API:er. Dessa API:er används också av Azure Time Series Insights TSI Explorer.

Tre primära API-kategorier är tillgängliga i Azure Time Series Insights Gen2:

  • Miljö-API:er: Dessa API:er möjliggör frågor Azure Time Series Insights Gen2-miljön. Dessa kan användas för att samla in listan över miljöer som anroparen har åtkomst till och miljömetadata.
  • Time Series Model-Query -API:er (TSM-Q): Gör det möjligt att skapa, läsa, uppdatera och ta bort (CRUD)-åtgärder för metadata som lagras i time seriesmodellen för miljön. Dessa kan användas för att komma åt och redigera instanser, typer och hierarkier.
  • Api:er för Time Series Query (TSQ): Möjliggör hämtning av telemetri- eller händelsedata när de registreras från källprovidern och möjliggör prestandaberäkningar och aggregeringar på data med hjälp av avancerade skalära och aggregeringsfunktioner.

Azure Time Series Insights Gen2 använder ett omfattande strängbaserat uttrycksspråk, Time Series Expression (TSX), för att uttrycka beräkningar i Time Series-variabler.

Azure Time Series Insights Gen2-API:er – översikt

Följande grundläggande API:er stöds.

Översikt över Time Series-fråga

Miljö-API:er

  • Api:et Hämtamiljöer: Returnerar listan över miljöer som anroparen har behörighet att komma åt.
  • Get Environments Availability API (Hämta tillgänglighets-APIför miljöer): Returnerar fördelningen av antalet händelser över händelsetidsstämpeln $ts . Det här API:et hjälper dig att avgöra om det finns några händelser i miljön genom att returnera antalet händelser uppdelade i tidsintervall, om det finns några.
  • Hämta API för händelseschema:Returnerar metadata för händelseschemat för ett visst sökintervall. Det här API:et hjälper till att hämta alla metadata och egenskaper som är tillgängliga i schemat för det angivna sökintervallet.

API:er för Time Series Model-Query (TSM-Q)

De flesta av dessa API:er stöder batchkörningsåtgärd för att aktivera BATCH CRUD-åtgärder på flera Time Series Model-entiteter:

  • API för modellinställningar: Aktiverar GET och PATCH på standardtypen och modellnamnet för miljön.
  • Typ-API:Aktiverar CRUD för time series-typer och deras associerade variabler.
  • Hierarki-API:Aktiverar CRUD på Tidsseriehierarkier och deras associerade fältsökvägar.
  • Instans-API:Aktiverar CRUD på Time Series-instanser och deras associerade instansfält. Dessutom stöder INSTANS-API:et följande åtgärder:
    • Search: Hämtar en partiell lista över träffar vid sökning efter tidsserieinstanser baserat på instansattribut.
    • Föreslå: Söker och föreslår en partiell lista över träffar vid sökning efter tidsserieinstanser baserat på instansattribut.

API:er för Time Series Query (TSQ)

Dessa API:er är tillgängliga i båda lagringsplatserna (varm och kall) i vår lagringslösning med flera lager.

  • API för att hämtahändelser: Aktiverar fråga och hämtning av råhändelser och associerade tidsstämplar för händelser när de registreras i Azure Time Series Insights Gen2 från källprovidern. Det här API:et gör det möjligt att hämta råhändelser för ett visst Time Series-ID och sökintervall. Det här API:et stöder sidnumrering för att hämta den fullständiga svarsdatauppsättningen för valda indata.

    Viktigt

    Som en del av kommande ändringar av regler för JSON-utplattningoch undantag lagras matriser som dynamisk typ. Nyttolastegenskaper som lagras eftersom den här typen ENDAST är tillgängliga via API:et Get Events.

  • Hämta serie-API:Aktiverar fråga och hämtning av beräknade värden och associerade tidsstämplar för händelser genom att tillämpa beräkningar som definieras av variabler för råhändelser. Dessa variabler kan definieras antingen i tidsseriemodellen eller anges som infogade i frågan. Det här API:et stöder sidnumrering för att hämta den fullständiga svarsdatauppsättningen för valda indata.

  • API förmängdserier: Gör det möjligt att köra frågor mot och hämta aggregerade värden och associerade tidsintervallsstämplar genom att tillämpa beräkningar som definieras av variabler på råhändelser. Dessa variabler kan definieras antingen i tidsseriemodellen eller anges som infogade i frågan. Det här API:et stöder sidnumrering för att hämta den fullständiga svarsdatauppsättningen för valda indata.

    För ett angivet sökintervall och intervall returnerar det här API:et ett aggregerat svar per intervall per variabel för ett Time Series-ID. Antalet intervall i svarsdatamängden beräknas genom att räkna epok-tick (antalet millisekunder som har förflutit sedan Unix-epoken – 1 januari 1970) och dividera ticken med intervallintervallstorleken som anges i frågan.

    De tidsstämplar som returneras i svarsuppsättningen är av de vänstra intervallgränserna, inte för de samplade händelserna från intervallet.

Välja Butikstyp

Ovanstående API:er kan bara köras mot en av de två lagringstyperna (kall eller varm) i ett enda anrop. Fråge-URL-parametrar används för att ange vilken butikstyp frågan ska köras på.

Om ingen parameter anges körs frågan i Cold Store som standard. Om en fråga sträcker sig över ett tidsintervall som överlappar både kall och varm lagring, rekommenderar vi att du dirigerar frågan till Kall lagring för bästa möjliga upplevelse eftersom varm lagring endast innehåller partiella data.

Den Azure Time Series Insights Explorer och Power BI Connector gör anrop till ovanstående API:er och väljer automatiskt rätt storeType-parameter där det är relevant.

Nästa steg