Datenabfragen in Azure Time Series Insights PreviewData querying in Azure Time Series Insights Preview

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

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

  • Umgebungs-APIs: Diese APIs ermöglichen Abfragen der Time Series Insights-Umgebung selbst.Environment APIs: These APIs enable queries on the Time Series Insights environment itself. Beispiele für Abfragen sind die Liste der Umgebungen, auf die der Aufrufer Zugriff hat, sowie Umgebungsmetadaten.Examples of queries are the list of environments the caller has access to and environment metadata.
  • Zeitreihenmodellabfrage (TSM-Q)-APIs: Ermöglicht das Erstellen, Lesen, Aktualisieren und Löschen (CRUD) von Vorgängen mit Metadaten, die im Umgebungsteil des Zeitreihenmodells gespeichert sind.Time Series Model-Query (TSM-Q) APIs: Enables create, read, update, and delete (CRUD) operations on metadata stored in the environment part of the time series model. Beispiele sind Instanzen, Typen und Hierarchien.Examples are instances, types, and hierarchies.
  • Zeitreihenabfrage (TSQ)-APIs: Ermöglicht das Abrufen von Telemetrie- oder Ereignisdaten, wie sie vom Quellanbieter aufgezeichnet werden, oder durch Reduzieren der Daten mithilfe von Skalar- und Aggregatfunktionen, die in einem Teil der Variablen gespeichert sind.Time Series Query (TSQ) APIs: Enables retrieval of telemetry or events data as it's recorded from the source provider or by reducing the data using scalar and aggregate functions stored part of variables. Diese APIs können Vorgänge zum Transformieren und Kombinieren sowie Berechnungen auf Zeitreihendaten anwenden.These APIs can perform operations to transform, combine, and apply computations on time series data.

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

Kern-APIs von Azure Time Series Insights PreviewAzure Time Series Insights Preview core APIs

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

Zeitreihenabfrage (TSQ): ÜbersichtTime Series Query overview

Umgebungs-APIsEnvironment APIs

Die folgenden Umgebungs-APIs sind verfügbar:The following Environment APIs are available:

  • „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 bestimmen, ob Ereignisse in dem Zeitstempel vorhanden sind, indem die Anzahl von Ereignissen, sofern welche vorhanden sind, zurückgegeben wird.This API helps determine if there are any events in the timestamp by returning the count of events, 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 folgenden Zeitreihenmodellabfrage-APIs sind verfügbar.The following Time Series Model-Query APIs are available. Die meisten dieser APIs unterstützen die Batchausführung, um Batch-CRUD-Vorgänge für mehrere Zeitreihenmodellentitäten 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

Die folgenden Zeitreihenabfrage-APIs sind verfügbar.The following Time Series Query APIs are available. Diese APIs sind in allen unterstützten mehrschichtigen Speichern in Time Series Insights verfügbar.These APIs are available on all supported multilayered storages in Time Series Insights. 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 Time Series Insights-Daten aus Ereignissen, während sie in Time Series Insights vom Quellenanbieter aufgezeichnet werden.Get Events API: Enables query and retrieval of Time Series Insights data from events as they're recorded in Time Series Insights 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 komplette Dataset für die ausgewählte Eingabe abzurufen.This API supports pagination to retrieve the complete dataset for the selected input.

  • „Reihe abrufen“-API: Ermöglicht das Abfragen und Abrufen von Time Series Insights-Daten aus erfassten Ereignissen, indem bei der Übertragung aufgezeichnete Daten verwendet werden.Get Series API: Enables query and retrieval of Time Series Insights data from captured events by using data recorded on the wire. Die zurückgegebenen Werte, basieren auf den Variablen, die im Modell definiert oder inline angegeben wurden.The values that are returned are based on the variables that were defined in the model or provided inline. Diese API unterstützt die Paginierung, um das komplette Dataset für die ausgewählte Eingabe abzurufen.This API supports pagination to retrieve the complete dataset for the selected input. Diese API hilft bei der Definition von berechneten Eigenschaften oder Spalten.This API helps in defining calculated properties or columns.

    Hinweis

    Die Aggregationsklausel wird ignoriert, auch wenn sie in einem Modell oder inline angegeben wurde.The Aggregation clause is ignored even if it's specified in a model or provided inline.

    Die „Reihe abrufen“-API gibt einen Zeitreihenwert für jede Variable in jedem Intervall zurück.The Get Series API returns a Time Series value for each variable for each interval. Ein Zeitreihenwert ist ein Format, das Time Series Insights für die JSON-Ausgabe aus einer Abfrage verwendet.A Time Series value is a format that Time Series Insights uses for output JSON from a query. Die zurückgegebenen Werte, basieren auf der Time Series-ID und dem Satz von Variablen, die bereitgestellt wurden.The values that are returned are based on the Time Series ID and the set of variables that were provided.

  • „Reihe aggregieren“-API: Ermöglicht das Abfragen und Abrufen von Time Series Insights-Daten aus erfassten Ereignissen, indem Stichproben aus aufgezeichneten Daten entnommen und diese aggregiert werden.Aggregate Series API: Enables query and retrieval of Time Series Insights data from captured events by sampling and aggregating recorded data. Diese API unterstützt die kontinuierliche Ausführung durch die Verwendung von Fortsetzungstoken.This API supports continuable execution by using continuation tokens.

    Die „Reihe aggregieren“-API gibt einen Zeitreihenwert für jede Variable in jedem Intervall zurück.The Aggregate Series API returns a Time Series value for each variable for each interval. Die Werte basieren auf der Time Series-ID und dem Satz von Variablen, die bereitgestellt wurden.The values are based on the Time Series ID and the set of variables that were provided. Die „Reihe aggregieren“-API erreicht eine Verringerung unter Verwendung der Variablen, die im Zeitreihenmodell gespeichert sind oder inline bereitgestellt werden, um Daten zu aggregieren oder daraus Stichproben zu entnehmen.The Aggregate Series API achieves reduction by using variables stored in the Time Series Model or provided inline to aggregate or sample data.

Nächste SchritteNext steps