Freigeben über

Abfragen von Daten aus Azure Time Series Insights Gen2

  • Artikel

Anmerkung

Der Time Series Insights-Dienst wird am 7. Juli 2024 eingestellt. Erwägen Sie, vorhandene Umgebungen so schnell wie möglich zu alternativen Lösungen zu migrieren. Weitere Informationen zum Auslaufen und zur Migration finden Sie in unserer Dokumentation .

Azure Time Series Insights Gen2 ermöglicht datenabfragen für Ereignisse und Metadaten, die in der Umgebung über öffentliche Oberflächen-APIs gespeichert sind. Diese APIs werden auch vom Azure Time Series Insights TSI Explorerverwendet.

Drei primäre API-Kategorien sind in Azure Time Series Insights Gen2 verfügbar:

  • Umgebungs-APIs: Diese APIs ermöglichen Abfragen in der Azure Time Series Insights Gen2-Umgebung selbst. Diese können verwendet werden, um die Liste der Umgebungen zu erfassen, auf die der Aufrufer Zugriff hat, und Umgebungsmetadaten.
  • Zeitreihen-Model-Query (TSM-Q) APIs: Ermöglicht das Erstellen, Lesen, Aktualisieren und Löschen (CRUD) von Metadaten, die im Zeitreihenmodell der Umgebung gespeichert sind. Diese können verwendet werden, um auf Instanzen, Typen und Hierarchien zuzugreifen und sie zu bearbeiten.
  • TSQ-APIs (Time Series Query): Ermöglicht das Abrufen von Telemetrie- oder Ereignisdaten, wie sie vom Quellanbieter aufgezeichnet wird, und ermöglicht performante Berechnungen und Aggregationen für die Daten mithilfe erweiterter Skalar- und Aggregatfunktionen.

Azure Time Series Insights Gen2 verwendet eine umfangreiche zeichenfolgenbasierte Ausdruckssprache, Zeitreihenausdruck (TSX), um Berechnungen in Zeitreihenvariablendarzustellen.

Übersicht über Azure Time Series Insights Gen2-APIs

Die folgenden Kern-APIs werden unterstützt.

Übersicht über Zeitreihenabfragen

Umwelt-APIs

  • Get Environments API: Gibt die Liste der Umgebungen zurück, auf die der Anrufer zugreifen darf.
  • Get Environments Availability API: Gibt die Verteilung der Ereignisanzahl in Bezug auf den Ereigniszeitstempel $tszurück. Diese API hilft zu ermitteln, ob ereignisse in der Umgebung vorhanden sind, indem die Anzahl der Ereignisse zurückgegeben wird, die in Zeitintervalle unterteilt sind, sofern vorhanden.
  • Ereignisschema-APIabrufen: Gibt die Ereignisschemametadaten für eine bestimmte Suchspanne zurück. Diese API hilft beim Abrufen aller Metadaten und Eigenschaften, die im Schema für die angegebene Suchspanne verfügbar sind.

Zeitreihen Model-Query (TSM-Q) APIs

Die meisten dieser APIs unterstützen den Batch-Ausführungsvorgang, um die Batch-CRUD-Vorgänge für mehrere Zeitreihenmodell-Entitäten zu aktivieren.

  • Modelleinstellungen-API: Ermöglicht GET und PATCH für den Standardtyp und den Modellnamen der Umgebung.
  • Typen-API: Aktiviert CRUD für Zeitreihentypen und die zugehörigen Variablen.
  • Hierarchien-API-: Aktiviert CRUD für Zeitreihenhierarchien und die zugehörigen Feldpfade.
  • Instanzen-API: Ermöglicht CRUD-Operationen für Zeitserieninstanzen und deren zugeordnete Instanzfelder. Darüber hinaus unterstützt die Instanz-API die folgenden Vorgänge:
    • Search: Ruft eine Teilliste von Suchergebnissen für Zeitreiheninstanzen basierend auf Instanzattributen ab.
    • Vorschlagen: Durchsucht und schlägt eine Teilliste von Treffern bei der Suche nach Zeitreiheninstanzen basierend auf Instanzattributen vor.

Time Series Query (TSQ)-APIs

Diese APIs sind in beiden Speicherbereichen (Warm und Kalt) in unserer gestaffelten Speicherlösung verfügbar.

  • Get Events API: Ermöglicht die Abfrage und das Abrufen von rohen Ereignissen und den zugehörigen Ereigniszeitstempeln, wie sie in Azure Time Series Insights Gen2 vom Quellanbieter aufgezeichnet werden. Diese API ermöglicht das Abrufen von Rohereignissen für eine bestimmte Zeitreihen-ID und Suchspanne. Diese API unterstützt die Paginierung zum Abrufen des vollständigen Antwortdatensatzes für die ausgewählte Eingabe.

    Wichtig

    Im Rahmen der bevorstehenden Änderungen an JSON-Flattening- und Escaperegelnwerden Arrays als Dynamischer Typ gespeichert. Nutzlasteigenschaften, die als dieser Typ gespeichert sind, sind NUR über die Get Events APIzugänglich.

  • Get Series API: Ermöglicht das Abfragen und Abrufen von berechneten Werten und den zugehörigen Ereigniszeitstempeln, indem Berechnungen angewendet werden, die durch Variablen definiert sind und den Rohereignissen zugrunde liegen. Diese Variablen können entweder im Zeitreihenmodell oder direkt in der Abfrage definiert werden. Diese API unterstützt die Paginierung zum Abrufen des vollständigen Antwortdatensatzes für die ausgewählte Eingabe.

  • Aggregatreihen-API-: Ermöglicht das Abfragen und Abrufen aggregierter Werte und der zugeordneten Intervallzeitstempel, indem Berechnungen angewendet werden, die durch Variablen für Unformatierte Ereignisse definiert sind. Diese Variablen können entweder im Zeitreihenmodell oder direkt in der Abfrage definiert werden. Diese API unterstützt die Paginierung zum Abrufen des vollständigen Antwortdatensatzes für die ausgewählte Eingabe.

    Für eine angegebene Suchspanne und ein bestimmtes Intervall liefert diese API eine aggregierte Antwort pro Intervall und pro Variable für eine Zeitreihen-ID. Die Anzahl der Intervalle im Antwortdatensatz wird ermittelt, indem die Anzahl der Epoch-Zeitpunkte (Millisekunden, die seit der Unix-Epoche am 1. Januar 1970 verstrichen sind) gezählt und die Ticks durch die in der Abfrage angegebene Intervallspanne dividiert werden.

    Die im Antwortsatz zurückgegebenen Zeitstempel weisen die linken Intervallbegrenzungen auf, nicht die stichprobenierten Ereignisse aus dem Intervall.

Auswählen des Store-Typs

Die obigen APIs können nur für einen der beiden Speichertypen (Kalt oder Warm) in einem einzigen Aufruf ausgeführt werden. Abfrage-URL-Parameter werden verwendet, um den Speichertyp anzugeben, die Abfrage ausgeführt werden soll.

Wenn kein Parameter angegeben ist, wird die Abfrage standardmäßig im Cold Store ausgeführt. Wenn eine Abfrage einen Zeitraum einschließt, der sowohl den Kaltspeicher als auch den Warmspeicher überlappt, empfiehlt es sich, die Abfrage an den Kaltspeicher weiterzuleiten, um das beste Benutzererlebnis zu gewährleisten, da der Warmspeicher nur Teildaten enthält.

Der Azure Time Series Insights-Explorer und der Power BI Connector rufen die oben genannten APIs auf und wählen automatisch den richtigen storeType-Parameter, sofern relevant.

Nächste Schritte