Freigeben über

Abfragen von Daten in Azure Time Series Insights Gen2

  • Artikel

Hinweis

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

Azure Time Series Insights Gen2 ermöglicht das Abfragen von Daten für Ereignisse und Metadaten, die in der Umgebung gespeichert sind, über öffentliche Oberflächen-APIs. Diese APIs werden auch im Azure Time Series Insights TSI-Explorer verwendet.

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

  • Umgebungs-APIs: Diese APIs ermöglichen Abfragen der Azure Time Series Insights Gen2-Umgebung selbst. Sie ermöglichen das Zusammenstellen der Liste der Umgebungen, auf die der Aufrufer Zugriff hat, sowie von Umgebungsmetadaten.
  • TSM-Q-APIs (Time Series Model-Query, Zeitreihenmodellabfrage): Ermöglichen die Vorgänge zum Erstellen, Lesen, Aktualisieren und Löschen (Create, Read, Update, Delete, CRUD) für Metadaten, die im Zeitreihenmodell der Umgebung gespeichert sind. Diese können verwendet werden, um auf die Instanzen, Typen und Hierarchien zuzugreifen und sie zu bearbeiten.
  • TSQ-APIs (Time Series Query, Zeitreihenabfrage): Ermöglichen das Abrufen von Telemetrie- oder Ereignisdaten, wie sie vom Quellanbieter aufgezeichnet werden, sowie leistungsstarke Berechnungen und Aggregationen der Daten mithilfe von erweiterten Skalar- und Aggregatfunktionen.

Azure Time Series Insights Gen2 verwendet eine umfassende zeichenfolgenbasierte Ausdruckssprache, Time Series Expression, TSX (Zeitreihenausdrucksprache), um Berechnungen in Zeitreihenvariablen auszudrücken.

Übersicht über Azure Time Series Insights Gen2-APIs

Die folgenden Kern-APIs werden unterstützt.

Zeitreihenabfrage (TSQ): Übersicht

Umgebungs-APIs

  • API zum Abrufen von Umgebungen: Gibt die Liste der Umgebungen zurück, für die der Benutzer Zugriffsrechte hat.
  • „Umgebungsverfügbarkeit abrufen“-API: Gibt die Verteilung der Anzahl von Ereignissen über den Ereigniszeitstempel $ts zurück. Diese API hilft dabei, zu ermitteln, ob Ereignisse in der Umgebung vorhanden sind, indem die Anzahl von Ereignissen (sofern vorhanden) unterteilt in Zeitintervalle zurückgegeben wird.
  • API zum Abrufen von Ereignisschemas: Gibt die Ereignisschemametadaten für einen bestimmten Suchzeitraum zurück. Diese API hilft beim Abrufen aller Metadaten und Eigenschaften, die im Schema für den angegebenen Suchzeitraum zur Verfügung stehen.

Zeitreihenmodellabfrage (TSM-Q)-APIs

Die meisten dieser APIs unterstützen die Batchausführung, um Batch-CRUD-Vorgänge für mehrere Entitäten von Zeitreihenmodellen zu ermöglichen:

  • Modelleinstellungs-API: Ermöglicht GET und PATCH für den Standardtyp und den Modellnamen der Umgebung.
  • Typen-API: Ermöglicht CRUD mit Zeitreihentypen und deren zugeordneten Variablen.
  • Hierarchien-API: Ermöglicht CRUD mit Zeitreihenhierarchien und deren zugeordneten Feldpfaden.
  • Instanzen-API: Ermöglicht CRUD mit Zeitreiheninstanzen und deren zugeordneten Instanzenfeldern. Zusätzlich unterstützt die Instanzen-API die folgenden Vorgänge:
    • Suchen: Ruft eine unvollständige Liste der Treffer bei der Suche nach Zeitreiheninstanzen basierend auf Instanzattributen ab.
    • Vorschlagen: Sucht eine unvollständige Liste der Treffer bei der Suche nach Zeitreiheninstanzen basierend auf Instanzattributen und schlägt sie vor.

Zeitreihenabfrage (TSQ)-APIs

Diese APIs sind in beiden Speichern (warm und kalt) unserer mehrschichtigen Speicherlösung verfügbar.

  • API zum Abrufen von Ereignissen: Ermöglicht das Abfragen und Abrufen von unformatierten Ereignissen und den zugehörigen Zeitstempeln, 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 Suchzeitspanne. Diese API unterstützt die Paginierung, um das vollständige Antwortdataset für die ausgewählte Eingabe abzurufen.

    Wichtig

    Im Rahmen der bevorstehenden Änderungen für JSON-Vereinfachungs- und -Escaperegeln werden Arrays mit dem Typ Dynamic gespeichert. Nutzlasteigenschaften, die mit diesem Typ gespeichert werden, sind NUR über die Ereignisabruf-API zugänglich.

  • API zum Abrufen von Reihen: Ermöglicht das Abfragen und Abrufen berechneter Werte und der zugehörigen Ereigniszeitstempel durch Anwenden von Berechnungen, die durch Variablen in unformatierten Ereignissen definiert werden. Diese Variablen können im Zeitreihenmodell definiert oder in der Abfrage bereitgestellt werden. Diese API unterstützt die Paginierung, um das vollständige Antwortdataset für die ausgewählte Eingabe abzurufen.

  • API zum Aggregieren von Reihen: Ermöglicht das Abfragen und Abrufen aggregierter Werte und der zugehörigen Intervallzeitstempel durch Anwenden von Berechnungen, die durch Variablen in unformatierten Ereignissen definiert werden. Diese Variablen können im Zeitreihenmodell definiert oder in der Abfrage bereitgestellt werden. Diese API unterstützt die Paginierung, um das vollständige Antwortdataset für die ausgewählte Eingabe abzurufen.

    Diese API gibt für eine angegebene Suchzeitspanne und ein angegebenes Intervall eine aggregierte Antwort pro Intervall pro Variable für eine Zeitreihen-ID zurück. Die Anzahl der Intervalle im Antwortdataset wird durch Zählen der Epochenticks (Anzahl der Millisekunden seit Beginn der Unix-Epoche am 1. Januar 1970) und die Division der Ticks durch die in der Abfrage angegebene Intervallzeitspanne berechnet.

    Die im Antwortdataset zurückgegebenen Zeitstempel stellen die linken Intervallgrenzen dar, nicht die Stichprobenereignisse im Intervall.

Auswählen des Speichertyps

Die obigen APIs können nur für einen der beiden Speichertypen („kalt“ oder „warm“) in einem einzelnen Aufruf ausgeführt werden. Parameter zum Abfragen der URL werden verwendet, um den Speichertyp anzugeben, für den die Abfrage ausgeführt werden soll.

Wenn kein Parameter angegeben wird, wird die Abfrage standardmäßig im kalten Speicher ausgeführt. Wenn eine Abfrage einen Zeitraum beansprucht, in dem sowohl kalter als auch warmer Speicher genutzt wird, empfiehlt es sich, für eine optimale Erfahrung die Abfrage an den kalten Speicher weiterzuleiten, weil der warme Speicher nur teilweise Daten enthalten wird.

Azure Time Series Insights-Explorer und der Power BI- Connector führen Aufrufe an die obigen APIs aus und wählen automatisch den richtigen „storeType“-Parameter aus, wenn dies relevant ist.

Nächste Schritte