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

  • Artikel

Anteckning

Tjänsten Time Series Insights (TSI) stöds inte längre efter mars 2025. Överväg att migrera befintliga TSI-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 aktiverar datafrågor för händelser och metadata som lagras i miljön via OFFENTLIGA SURFACE-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 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 time series-modellen i miljön. Dessa kan användas för att komma åt och redigera instanser, typer och hierarkier.
  • TSQ-API:er (Time Series Query): Aktiverar 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 händelseantalet ö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 indelade 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örning för att aktivera CRUD-batchå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.
  • 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.

  • Hämta händelse-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 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 de valda indata.

    Viktigt

    Som en del av de kommande ändringarna av regler för JSON-utplattande och undflyende 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 Time Series-modellen 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 mängdserie: Aktiverar frågor och hämtning av aggregerade värden och associerade tidsstämplar för intervall genom att tillämpa beräkningar som definierats av variabler på råhändelser. Dessa variabler kan definieras i antingen Time Series-modellen 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 Time Series-ID. Antalet intervall i svarsdatauppsättningen beräknas genom att räkna tidsintervall (antalet millisekunder som har förflutit sedan Unix-epoken – 1 januari 1970) och dividera fästingarna med intervallintervallstorleken som angetts 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

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 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 kallt och varmt lager 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 ovanstående API:er och väljer automatiskt rätt storeType-parameter där det är relevant.

Nästa steg