Dela via

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

  • Artikel

Kommentar

Time Series Insights-tjänsten dras tillbaka den 7 juli 2024. Överväg att migrera befintliga miljöer till alternativa lösningar så snart som möjligt. Mer information om utfasning och migrering finns i vår dokumentation.

Azure Time Series Insights Gen2 möjliggör datafrågor för händelser och metadata som lagras i miljön via API:er för offentlig yta. 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 aktiverar frågor i själva 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): Aktiverar crud-åtgärder (create, read, update och delete) för metadata som lagras i tidsseriemodellen för miljön. Dessa kan användas för att komma åt och redigera instanser, typer och hierarkier.
  • Time Series Query-API:er (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 av data med hjälp av avancerade skalär- och aggregeringsfunktioner.

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

Översikt över Azure Time Series Insights Gen2-API:er

Följande kärn-API:er stöds.

Översikt över Time Series Query

Miljö-API:er

  • Hämta miljö-API: Returnerar listan över miljöer som anroparen har behörighet att komma åt.
  • Hämta API för miljötillgänglighet: 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 som är 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 dig 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örning 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 tidsserietyper och deras associerade variabler.
  • Api för hierarkier: Aktiverar CRUD i 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:
    • Sök: Hämtar en partiell lista över träffar vid sökning efter tidsserieinstanser baserat på instansattribut.
    • Föreslå: Söker efter och föreslår en partiell lista över träffar vid sökning efter tidsserieinstanser baserat på instansattribut.

TSQ-API:er (Time Series Query)

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

  • Get Events API: Aktiverar frågor 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 tillåter hämtning av råhändelser för ett visst Tidsserie-ID och sökintervall. Det här API:et stöder sidnumrering för att hämta den fullständiga svarsdatauppsättningen för de valda indata.

    Viktigt!

    Som en del av de kommande ändringarna av regler för JSON-utplattande och undantag lagras matriser som dynamisk typ. Nyttolastegenskaper som lagras som den här typen är ENDAST tillgängliga via API:et Hämta händelser.

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

  • API för sammanställd serie: Aktiverar frågor och hämtning av aggregerade värden och associerade intervalltidsstämplar genom att tillämpa beräkningar som definierats av variabler på råhändelser. Dessa variabler kan definieras i antingen Tidsseriemodellen eller anges infogade i frågan. Det här API:et stöder sidnumrering för att hämta den fullständiga svarsdatauppsättningen för de 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 Tidsserie-ID. Antalet intervall i svarsdatauppsättningen beräknas genom att räkna epoks tick (antalet millisekunder som har förflutit sedan Unix-epoken – 1 januari 1970) och dividera fästingarna med den intervallintervallstorlek som anges i frågan.

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

Välja butikstyp

Api:erna ovan 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 den lagringstyp som frågan ska köras på.

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

Azure Time Series Insights Explorer och Power BI Connector anropar api:erna ovan och väljer automatiskt rätt storeType-parameter där det är relevant.

Nästa steg