render-Operator

Wechseln Sie Dienste mit der Dropdownliste "Version". Weitere Informationen zur Navigation.
Gilt für: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Der render Operator weist den Benutzer-Agent an, Abfrageergebnisse zu visualisieren. Es muss der letzte Operator in Ihrer Abfrage sein und funktioniert nur mit Abfragen, die einen einzelnen tabellarischen Datenstrom erzeugen.

Der Operator ändert keine Daten. Stattdessen wird eine "Visualisierung" Anmerkung zu den erweiterten Eigenschaften des Ergebnisses hinzugefügt, die die Visualisierungsanweisungen aus Ihrer Abfrage enthalten. Verschiedene Benutzer-Agents, z. B. Kusto.Explorer oder Azure Data Explorer Webbenutzeroberfläche, interpretieren und unterstützen verschiedene Visualisierungen basierend auf diesen Informationen.

Das Datenmodell des render-Operators prüft die tabellarischen Daten so, als wären es drei Arten von Spalten vorhanden:

  • Die Spalte der x-Achse (angegeben durch die xcolumn-Eigenschaft).
  • Die Datenreihenspalten (eine beliebige Anzahl von Spalten, die durch die series Eigenschaft angegeben sind.) Für jeden Datensatz definieren die kombinierten Werte dieser Spalten eine einzelne Datenreihe, und das Diagramm weist so viele Datenreihen auf, wie es unterschiedliche kombinierte Werte gibt.
  • Die Spalten der y-Achse (eine beliebige Anzahl von Spalten, die durch die ycolumns-Eigenschaft angegeben werden). Für jeden Datensatz enthält die Reihe so viele Messungen („Punkte“ im Diagramm), wie Spalten der y-Achse vorhanden sind.

Tipp

  • Verwenden Sie where, summarize und top, um das angezeigter Volumen einzuschränken.
  • Sortieren Sie die Daten, um die Reihenfolge der x-Achse zu definieren.
  • Benutzer-Agents können den Wert von Eigenschaften „erraten“, die nicht durch die Abfrage angegeben werden. Insbesondere kann es vorkommen, dass „uninteressante“ Spalten im Schema des Ergebnisses dazu führen, dass sie falsch raten. Versuchen Sie, solche Spalten wegzuprojizieren, wenn dies geschieht.

Hinweis

Es gibt einige Visualisierungen, die nur in Azure Data Explorer-Dashboards verfügbar sind. Weitere Informationen finden Sie unter Dashboardspezifische visuelle Elemente.

Syntax

T-Visualisierung|render [ with( propertyName = propertyValue [, ...]])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
T string ✔️ Eingabetabellenname.
Visualisierung string ✔️ Gibt die Art der zu verwendenden Visualisierung an. Muss einer der unterstützten Werte in der folgenden Liste sein.
Eigenschaftsname, Eigenschaftswert string Eine durch Trennzeichen getrennte Liste von Schlüsselwert-Eigenschaftspaaren. Siehe unterstützte Eigenschaften.

Visualisierung

Visualisierung Beschreibung Abbildung
anomalychart Ähnlich wie das Zeitdiagramm, hebt jedoch Anomalien mithilfe der series_decompose_anomalies-Funktion hervor.
areachart Bereichsdiagramm.
barchart Als horizontale Streifen angezeigt.
card Der erste Ergebnisdatensatz ist eine Reihe skalarer Werte und wird als Karte angezeigt.
columnchart Wie barchart mit vertikalen Streifen anstelle von horizontalen Streifen.
ladderchart Die letzten beiden Spalten sind die X-Achse, und andere Spalten sind y-Achse.
linechart Liniendiagramm.
piechart Die erste Spalte ist die Farbachse, und die zweite Spalte ist numerisch.
pivotchart Zeigt eine Pivottabelle und ein Diagramm an. Sie können Daten, Spalten, Zeilen und verschiedene Diagrammtypen interaktiv auswählen.
scatterchart Punktdiagramm.
stackedareachart Gestapeltes Flächendiagramm.
table Ergebnisse werden standardmäßig als Tabelle angezeigt.
timechart Liniendiagramm. Die erste Spalte ist die X-Achse und muss datumstime sein. Andere (numerische) Spalten werden als y-Achsen verwendet.
timepivot Interaktive Navigation über die Zeitlinie von Ereignissen (Pivoting on time axis).
treemap Zeigt hierarchische Daten als Satz geschachtelter Rechtecke an.

Hinweis

Die Visualisierungen "Leiterdiagramm", "Pivotchart", "Timepivot" und "Treemap" können in Kusto.Explorer verwendet werden, sind aber in der Azure Data Explorer Webbenutzeroberfläche nicht verfügbar.

Visualisierung Beschreibung Abbildung
areachart Bereichsdiagramm. Die erste Spalte ist die X-Achse und sollte eine numerische Spalte sein. Andere numerische Spalten werden als y-Achsen verwendet.
barchart Die erste Spalte ist die X-Achse und kann Text, Datum/Uhrzeit oder numerisch sein. Andere Spalten sind numerisch und werden als horizontale Streifen angezeigt.
columnchart Wie barchart mit vertikalen Streifen anstelle von horizontalen Streifen.
piechart Die erste Spalte ist die Farbachse, und die zweite Spalte ist numerisch.
scatterchart Punktdiagramm. Die erste Spalte ist die X-Achse und sollte eine numerische Spalte sein. Andere numerische Spalten werden als y-Achsen verwendet.
table Ergebnisse werden standardmäßig als Tabelle angezeigt.
timechart Liniendiagramm. Die erste Spalte ist die X-Achse und sollte datumstime sein. Andere (numerische) Spalten werden als y-Achsen verwendet. Es gibt eine Zeichenfolgenspalte, deren Werte verwendet werden, um die numerischen Spalten zu gruppieren und verschiedene Linien im Diagramm zu erstellen (weitere Zeichenfolgenspalten werden ignoriert).
Visualisierung Beschreibung Abbildung
anomalychart Ähnlich wie das Zeitdiagramm, hebt jedoch Anomalien mithilfe der series_decompose_anomalies-Funktion hervor.
areachart Bereichsdiagramm.
barchart Als horizontale Streifen angezeigt.
card Der erste Ergebnisdatensatz ist eine Reihe skalarer Werte und wird als Karte angezeigt.
columnchart Wie barchart mit vertikalen Streifen anstelle von horizontalen Streifen.
linechart Liniendiagramm.
piechart Die erste Spalte ist die Farbachse, und die zweite Spalte ist numerisch.
scatterchart Punktdiagramm.
stackedareachart Gestapeltes Flächendiagramm.
table Ergebnisse werden standardmäßig als Tabelle angezeigt.
timechart Liniendiagramm. Die erste Spalte ist die X-Achse und muss datumstime sein. Andere (numerische) Spalten werden als y-Achsen verwendet.

Unterstützte Eigenschaften

PropertyName/PropertyValue zusätzliche Informationen an, die beim Rendern verwendet werden sollen. Alle Eigenschaften sind optional. Folgende Eigenschaften werden unterstützt:

PropertyName PropertyValue
accumulate Gibt an, ob der Wert jedes Measures allen seinen Vorgängern hinzugefügt wird. (true oder false)
kind Weitere Erläuterung der Visualisierungsart. Weitere Informationen finden Sie unter kind "Property".
legend Gibt an, ob eine Legende angezeigt werden soll (visible oder hidden).
series Durch Trennzeichen getrennte Liste von Spalten, deren kombinierte Werte pro Datensatz die Reihen definieren, zu denen der Datensatz gehört.
ymin Der Minimalwert, der auf der Y-Achse angezeigt werden soll.
ymax Der Maximalwert, der auf der Y-Achse angezeigt werden soll.
title Der Titel der Visualisierung (vom Typ string).
xaxis Skalierungsart der x-Achse (linear oder log).
xcolumn Gibt an, welche Spalte im Ergebnis für die x-Achse verwendet wird.
xtitle Der Titel der x-Achse (vom Typ string).
yaxis Skalierungsart der y-Achse (linear oder log).
ycolumns Durch Trennzeichen getrennte Liste von Spalten, die aus den Werten bestehen, die pro Wert der x-Spalte bereitgestellt werden.
ysplit So teilen Sie die Visualisierung in mehrere Y-Achsenwerte auf. Weitere Informationen finden Sie unter y-split "Property".
ytitle Der Titel der y-Achse (vom Typ string).
anomalycolumns Eigenschaft, die nur für anomalychart relevant ist. Durch Trennzeichen getrennte Liste von Spalten, die als Anomaliereihen betrachtet und als Punkte im Diagramm angezeigt werden
PropertyName PropertyValue
kind Weitere Erläuterung der Visualisierungsart. Weitere Informationen finden Sie unter kind "Property".
series Durch Trennzeichen getrennte Liste von Spalten, deren kombinierte Werte pro Datensatz die Reihen definieren, zu denen der Datensatz gehört.
title Der Titel der Visualisierung (vom Typ string).

kind-Eigenschaft

Sie können diese Visualisierung weiter ausarbeiten, indem Sie die kind Eigenschaft bereitstellen. Die unterstützten Werte für diese Eigenschaft sind:

Visualisierung kind Beschreibung
areachart default Jeder „Bereich“ steht für sich selbst.
unstacked Wie in default.
stacked Stapelt „Bereiche“ auf der rechten Seite.
stacked100 Stapelt „Bereiche“ auf der rechten Seite und streckt diese auf die gleiche Breite wie die anderen.
barchart default Jeder „Balken“ steht für sich selbst.
unstacked Wie in default.
stacked Stapelt „Balken“.
stacked100 Stapelt „Balken“ und streckt diese auf die gleiche Breite wie die anderen.
columnchart default Jede „Spalte“ steht für sich selbst.
unstacked Wie in default.
stacked Stapelt „Spalten“ aufeinander.
stacked100 Stapelt „Spalten“ und streckt diese auf die gleiche Höhe wie die anderen.
scatterchart map Erwartete Spalten sind [Longitude, Latitude] oder „GeoJSON point“. Die Spalte „Series“ ist optional. Weitere Informationen finden Sie unter Geospatialvisualisierungen.
piechart map Erwartete Spalten sind [Longitude, Latitude] oder „GeoJSON point“, color-axis und „numeric“. Wird in Kusto Explorer-Desktop unterstützt. Weitere Informationen finden Sie unter Geospatialvisualisierungen.

ysplit-Eigenschaft

Einige Visualisierungen unterstützen das Aufteilen in mehrere Werte der y-Achse:

ysplit Beschreibung
none Für alle Reihendaten wird eine einzelne y-Achse angezeigt. (Standardwert)
axes Es wird ein einzelnes Diagramm mit mehreren y-Achsen angezeigt (eine Achse pro Reihe).
panels Für jeden ycolumn Wert wird ein Diagramm gerendert. Maximal fünf Panels.

So rendern Sie fortlaufende Daten

Verwenden Sie zum Rendern von Werten mehrere Visualisierungen, z linechart. B. , timechartund areachart. Diese Visualisierungen folgen dem konzeptuellen Modell:

  • Eine Spalte in der Tabelle stellt die x-Achse der Daten dar. Sie können diese Spalte explizit mithilfe der xcolumn Eigenschaft definieren. Wenn Sie sie nicht definieren, wählt der Benutzer-Agent die erste Spalte aus, die für die Visualisierung funktioniert.
    • Beispielsweise verwendet der Benutzer-Agent in der timechart Visualisierung die erste datetime Spalte.
    • Wenn diese Spalte vom Typ dynamic ist und ein Array enthält, werden die einzelnen Werte im Array als Werte der X-Achse behandelt.
  • Mindestens eine Spalte in der Tabelle stellt ein oder mehrere Measures dar, die je nach X-Achse variieren. Sie können diese Spalten explizit mithilfe der ycolumns Eigenschaft definieren. Wenn Sie sie nicht definieren, wählt der Benutzer-Agent alle Spalten aus, die für die Visualisierung funktionieren.
    • Beispielsweise verwendet der Benutzer-Agent in der timechart Visualisierung alle Spalten mit einem numerischen Wert, den Sie sonst nicht angegeben haben.
    • Wenn es sich bei der x-Achse um ein Array handelt, sollten die Werte jeder y-Achse auch ein Array einer ähnlichen Länge sein, wobei jede Y-Achse in einer einzelnen Spalte auftritt.
  • Null oder mehr Spalten in der Tabelle stellen einen eindeutigen Satz von Dimensionen dar, die die Measures gruppieren. Sie können diese Spalten mithilfe der series Eigenschaft angeben, oder der Benutzer-Agent wählt sie automatisch aus den Spalten aus, die andernfalls nicht angegeben sind.

Zugehöriger Inhalt

Hinweis

Das Datenmodell des render-Operators prüft die tabellarischen Daten so, als wären es drei Arten von Spalten vorhanden:

  • Die Spalte der x-Achse (angegeben durch die xcolumn-Eigenschaft).
  • Die Datenreihenspalten (eine beliebige Anzahl von Spalten, die durch die series Eigenschaft angegeben sind).
  • Die Spalten der y-Achse (eine beliebige Anzahl von Spalten, die durch die ycolumns-Eigenschaft angegeben werden). Für jeden Datensatz enthält die Reihe so viele Messungen („Punkte“ im Diagramm), wie Spalten der y-Achse vorhanden sind.

Beispiel

InsightsMetrics
| where Computer == "DC00.NA.contosohotels.com"
| where Namespace  == "Processor" and Name == "UtilizationPercentage"
| summarize avg(Val) by Computer, bin(TimeGenerated, 1h)
| render timechart
  • Last updated on