Dela via

Fråga ut data i Azure Time Series Insights Gen2

  • Artikel

Anteckning

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 på vår dokumentationssida .

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 (TSM-Q) API:er: Möjliggör CRUD-åtgärder (Create, Read, Update och Delete) för metadata som lagras i miljöns tidsseriemodell. Dessa kan användas för att komma åt och redigera instanser, typer och hierarkier.
  • TSQ-API:er (Time Series Query): Möjliggör hämtning av telemetri- eller händelsedata när de registreras från källprovidern och möjliggör högpresterande beräkningar och aggregeringar av data med hjälp av avancerade skalär- och aggregerade funktioner.

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

  • Get Environments API: Returnerar listan över miljöer som anroparen har behörighet att komma åt.
  • Get Environments Availability API: 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ändelseschema 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.
  • Types 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:
    • Search: 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.

API:er för tidsseriefrågor

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.

    Viktig

    Som en del av kommande ändringar av JSON-utplattning och escape-reglerkommer matriser att lagras 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.

  • Aggregerade Serien API: Aktiverar frågor och hämtning av aggregerade värden och intervallens associerade tidsstämplar genom att tillämpa beräkningar som definieras 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 svarsdatasetet beräknas genom att räkna epoktickar (antalet millisekunder som har förflutit sedan Unix-epoken – 1 januari 1970) och dividera tickarna med den intervallstorlek 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 store-typ 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 anropa ovanstående API:er och väljer automatiskt rätt storeType-parameter där det är relevant.

Nästa steg