Abfragen von Daten in Azure Time Series Insights Gen2Querying Data from Azure Time Series Insights Gen2

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.Azure Time Series Insights Gen2 enables data querying on events and metadata stored in the environment via public surface APIs. Diese APIs werden auch im Azure Time Series Insights Gen2-Explorer verwendet.These APIs also are used by the Azure Time Series Insights Gen2 Explorer.

Drei primäre API-Kategorien sind in Azure Time Series Insights Gen2 verfügbar:Three primary API categories are available in Azure Time Series Insights Gen2 :

  • Umgebungs-APIs: Diese APIs ermöglichen Abfragen der Azure Time Series Insights Gen2-Umgebung selbst.Environment APIs: These APIs enable queries on the Azure Time Series Insights Gen2 environment itself. Sie ermöglichen das Zusammenstellen der Liste der Umgebungen, auf die der Aufrufer Zugriff hat, sowie von Umgebungsmetadaten.These can be used to gather the list of environments the caller has access to and environment metadata.
  • Zeitreihenmodellabfrage (TSM-Q)-APIs: Ermöglicht die Vorgänge Erstellen, Lesen, Aktualisieren und Löschen (Create, Read, Update, Delete, CRUD) mit Metadaten, die im Zeitreihenmodell der Umgebung gespeichert sind.Time Series Model-Query (TSM-Q) APIs: Enables create, read, update, and delete (CRUD) operations on metadata stored in the Time Series Model of the environment. Diese können verwendet werden, um auf die Instanzen, Typen und Hierarchien zuzugreifen und sie zu bearbeiten.These can be used to access and edit the instances, types, and hierarchies.
  • Zeitreihenabfrage (TSQ)-APIs: Ermöglicht 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.Time Series Query (TSQ) APIs: Enables retrieval of telemetry or events data as it's recorded from the source provider and enables performant computations and aggregations on the data using advanced scalar and aggregate functions.

Azure Time Series Insights Gen2 verwendet eine umfassende zeichenfolgenbasierte Ausdruckssprache, Time Series Expression, TSX (Zeitreihenausdrucksprache), um Berechnungen in Zeitreihenvariablen auszudrücken.Azure Time Series Insights Gen2 uses a rich string-based expression language, Time Series Expression (TSX), for expressing calculations in Time Series Variables.

Übersicht über Azure Time Series Insights Gen2-APIsAzure Time Series Insights Gen2 APIs overview

Die folgenden Kern-APIs werden unterstützt.The following core APIs are supported.

Zeitreihenabfrage (TSQ): ÜbersichtTime Series Query overview

Umgebungs-APIsEnvironment APIs

  • „Umgebungen abrufen“-API: Gibt die Liste der Umgebungen zurück, auf die der Benutzer zum Zugriff autorisiert ist.Get Environments API: Returns the list of environments that the caller is authorized to access.
  • „Umgebungsverfügbarkeit abrufen“-API: Gibt die Verteilung der Anzahl von Ereignissen über den Ereigniszeitstempel $ts zurück.Get Environments Availability API: Returns the distribution of event count over the event timestamp $ts. 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.This API helps determine if there are any events in the environment by returning the count of events broken into intervals of time, if any exist.
  • „Ereignisschema abrufen“-API: Gibt die Ereignisschema-Metadaten für einen bestimmten Suchzeitraum zurück.Get Event Schema API: Returns the event schema metadata for a given search span. Diese API hilft beim Abrufen aller Metadaten und Eigenschaften, die im Schema für den angegebenen Suchzeitraum zur Verfügung stehen.This API helps retrieve all metadata and properties available in the schema for the given search span.

Zeitreihenmodellabfrage (TSM-Q)-APIsTime Series Model-Query (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:Most of these APIs support batch execution operation to enable batch CRUD operations on multiple Time Series Model entities:

  • „Modelleinstellungen“-API: Ermöglicht GET und PATCH für den Standardtyp und den Modellnamen der Umgebung.Model Settings API: Enables GET and PATCH on the default type and the model name of the environment.
  • Typen-API: Ermöglicht CRUD mit Zeitreihentypen und deren zugeordneten Variablen.Types API: Enables CRUD on Time Series types and their associated variables.
  • Hierarchien-API: Ermöglicht CRUD mit Zeitreihenhierarchien und deren zugeordneten Feldpfaden.Hierarchies API: Enables CRUD on Time Series hierarchies and their associated field paths.
  • Instanzen-API: Ermöglicht CRUD mit Zeitreiheninstanzen und deren zugeordneten Instanzenfeldern.Instances API: Enables CRUD on Time Series instances and their associated instance fields. Zusätzlich unterstützt die Instanzen-API die folgenden Vorgänge:Additionally, the Instances API supports the following operations:
    • Suchen: Ruft eine unvollständige Liste der Treffer bei der Suche nach Zeitreiheninstanzen basierend auf Instanzattributen ab.Search: Retrieves a partial list of hits on search for time series instances based on instance attributes.
    • Vorschlagen: Sucht eine unvollständige Liste der Treffer bei der Suche nach Zeitreiheninstanzen basierend auf Instanzattributen und schlägt sie vor.Suggest: Searches and suggests a partial list of hits on search for time series instances based on instance attributes.

Zeitreihenabfrage (TSQ)-APIsTime Series Query (TSQ) APIs

Diese APIs sind in beiden Speichern (warm und kalt) unserer mehrschichtigen Speicherlösung verfügbar.These APIs are available across both stores (Warm and Cold) in our multilayered storage solution. Parameter zum Abfragen der URL werden verwendet, um den Speichertyp anzugeben, für den die Abfrage ausgeführt werden soll:Query URL parameters are used to specify the store type the query should execute on:

  • „Ereignisse abrufen“-API: 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.Get Events API: Enables query and retrieval of raw events and the associated event timestamps as they're recorded in Azure Time Series Insights Gen2 from the source provider. Diese API ermöglicht das Abrufen von Rohereignissen für eine bestimmte Zeitreihen-ID und Suchzeitspanne.This API allows retrieval of raw events for a given Time Series ID and search span. Diese API unterstützt die Paginierung, um das vollständige Antwortdataset für die ausgewählte Eingabe abzurufen.This API supports pagination to retrieve the complete response dataset for the selected input.

    Wichtig

  • „Reihe abrufen“-API: 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.Get Series API: Enables query and retrieval of computed values and the associated event timestamps by applying calculations defined by variables on raw events. Diese Variablen können im Zeitreihenmodell definiert oder in der Abfrage bereitgestellt werden.These variables can be defined in either the Time Series Model or provided inline in the query. Diese API unterstützt die Paginierung, um das vollständige Antwortdataset für die ausgewählte Eingabe abzurufen.This API supports pagination to retrieve the complete response dataset for the selected input.

  • „Reihe aggregieren“-API: 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.Aggregate Series API: Enables query and retrieval of aggregated values and the associated interval timestamps by applying calculations defined by variables on raw events. Diese Variablen können im Zeitreihenmodell definiert oder in der Abfrage bereitgestellt werden.These variables can be defined in either the Time Series Model or provided inline in the query. Diese API unterstützt die Paginierung, um das vollständige Antwortdataset für die ausgewählte Eingabe abzurufen.This API supports pagination to retrieve the complete response dataset for the selected input.

    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.For a specified search span and interval, this API returns an aggregated response per interval per variable for a Time Series ID. 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.The number of intervals in the response dataset is calculated by counting epoch ticks (the number of milliseconds that have elapsed since Unix epoch - Jan 1st, 1970) and dividing the ticks by the interval span size specified in the query.

    Die im Antwortdataset zurückgegebenen Zeitstempel stellen die linken Intervallgrenzen dar, nicht die Stichprobenereignisse im Intervall.The timestamps returned in the response set are of the left interval boundaries, not of the sampled events from the interval.

Nächste SchritteNext steps