render-Operator

  • Artikel

Weist den Benutzer-Agent an, eine Visualisierung der Abfrageergebnisse zu rendern.

Der Renderoperator muss der letzte Operator in der Abfrage sein und kann nur mit Abfragen verwendet werden, die ein einzelnes Tabellendatenstromergebnis erzeugen. Der Renderoperator ändert keine Daten. Sie fügt eine Anmerkung („Visualisierung“) in die erweiterten Eigenschaften des Ergebnisses ein. Die Anmerkung enthält die Informationen, die vom Operator in der Abfrage bereitgestellt werden. Die Interpretation der Visualisierungsinformationen erfolgt über den Benutzer-Agent. Verschiedene Agents, z. B. Kusto. Explorer oder die Azure Data Explorer-Weboberfläche können verschiedene Visualisierungen unterstützen.

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 Reihenspalten (eine beliebige Anzahl von Spalten, die von der series -Eigenschaft angegeben werden.) Für jeden Datensatz definieren die kombinierten Werte dieser Spalten eine einzelne Reihe, und das Diagramm verfügt über so viele Reihen, wie es verschiedene 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 Visuals.

Syntax

T|rendervisualization [with(propertyName=propertyValue [, ...])]

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ Erforderlich Beschreibung
T string ✔️ Name der Eingabetabelle.
Visualisierung string ✔️ Gibt die Art der zu verwendenden Visualisierung an. Muss einer der unterstützten Werte in der folgenden Liste sein.
propertyName, propertyValue string Eine durch Trennzeichen getrennte Liste von Schlüssel-Wert-Eigenschaftspaaren. Weitere Informationen finden Sie unter unterstützte Eigenschaften.

Visualisierung

Visualisierung BESCHREIBUNG Abbildung
anomalychart Ähnlich wie timechart, hebt Anomalien jedoch mit der series_decompose_anomalies-Funktion hervor.
areachart Bereichsdiagramm.
barchart wird als horizontale Streifen angezeigt.
card Der erste Ergebnisdatensatz wird als Satz von Skalarwerten behandelt und als Karte angezeigt.
columnchart Wie barchart mit vertikalen Streifen anstelle von horizontalen Streifen.
ladderchart Die letzten zwei Spalten sind die x-Achse, andere Spalten sind die y-Achse.
linechart ein Liniendiagramm.
piechart Die erste Spalte ist eine Farbachse, die zweite Spalte enthält Zahlen.
pivotchart Zeigt eine Pivottabelle und ein Diagramm an. Der Benutzer kann Daten, Spalten, Zeilen und verschiedene Diagrammtypen interaktiv auswählen.
scatterchart Punktdiagramm.
stackedareachart Gestapeltes Flächendiagramm.
table Ergebnisse werden standardmäßig als Tabelle angezeigt.
timechart ein Liniendiagramm. Die erste Spalte ist x-Achse und muss datetime sein. Andere (numerische) Spalten werden als y-Achsen verwendet.
timepivot Interaktive Navigation durch die Ereignisse der Zeitachse (Pivotierung auf der Zeitachse).
treemap Zeigt hierarchische Daten als Satz geschachtelter Rechtecke an.

Hinweis

Die Leiterdiagramm-, Pivotchart-, TimePivot- und Treemap-Visualisierungen können in Kusto verwendet werden. Explorer, sind aber nicht auf der Azure Data Explorer-Weboberfläche verfügbar.

Visualisierung BESCHREIBUNG Abbildung
areachart Bereichsdiagramm. Die erste Spalte ist die x-Achse und muss eine numerische Spalte sein. Andere numerische Spalten werden als y-Achsen verwendet.
barchart Die erste Spalte ist die x-Achse und kann Text, DateTime oder numerische Daten enthalten. 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 eine Farbachse, die zweite Spalte enthält Zahlen.
scatterchart Punktdiagramm. Die erste Spalte ist die x-Achse und muss eine numerische Spalte sein. Andere numerische Spalten werden als y-Achsen verwendet.
table Ergebnisse werden standardmäßig als Tabelle angezeigt.
timechart ein Liniendiagramm. Die erste Spalte ist die X-Achse und muss einen datetime-Wert enthalten. 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 timechart, hebt Anomalien jedoch mit der series_decompose_anomalies-Funktion hervor.
areachart Bereichsdiagramm.
barchart wird als horizontale Streifen angezeigt.
card Der erste Ergebnisdatensatz wird als Satz von Skalarwerten behandelt und als Karte angezeigt.
columnchart Wie barchart mit vertikalen Streifen anstelle von horizontalen Streifen.
linechart ein Liniendiagramm.
piechart Die erste Spalte ist eine Farbachse, die zweite Spalte enthält Zahlen.
scatterchart Punktdiagramm.
stackedareachart Gestapeltes Flächendiagramm.
table Ergebnisse werden standardmäßig als Tabelle angezeigt.
timechart ein Liniendiagramm. Die erste Spalte ist x-Achse und muss datetime 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 Eigenschaft.
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 Vorgehensweise beim Aufteilen mehrerer Visualisierungen Weitere Informationen finden Sie unter y-split Eigenschaft.
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 Eigenschaft.
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

Diese Visualisierung kann durch Bereitstellen der kind -Eigenschaft weiter erläutert werden. Die unterstützten Werte dieser 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 Geovisualisierungen.
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 Geovisualisierungen.

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 Ein Diagramm wird für jeden ycolumn-Wert (bis zu einem Grenzwert) gerendert.

Rendern fortlaufender Daten

Mehrere Visualisierungen werden zum Rendern von Sequenzen von Werten verwendet, linechartz. B. , timechartund areachart. Diese Visualisierungen verfügen über das folgende konzeptionelle Modell:

  • Eine Spalte in der Tabelle stellt die x-Achse der Daten dar. Diese Spalte kann explizit mithilfe der xcolumn -Eigenschaft definiert werden. Falls nicht definiert, wählt der Benutzer-Agent die erste Spalte aus, die für die Visualisierung geeignet ist.
    • Beispiel: In der timechart Visualisierung verwendet der Benutzer-Agent 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. Diese Spalten können explizit mithilfe der ycolumns -Eigenschaft definiert werden. Wenn nicht definiert, wählt der Benutzer-Agent alle Spalten aus, die für die Visualisierung geeignet sind.
    • Beispiel: In der timechart Visualisierung verwendet der Benutzer-Agent alle Spalten mit einem numerischen Wert, der andernfalls nicht angegeben wurde.
    • Wenn die x-Achse ein Array ist, sollten die Werte jeder y-Achse auch ein Array ähnlicher 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. Diese Spalten können durch die series -Eigenschaft angegeben werden, oder der Benutzer-Agent wählt sie automatisch aus den Spalten aus, die andernfalls nicht angegeben sind.

Verwandte Inhalte

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 Reihenspalten (eine beliebige Anzahl von Spalten, die durch die series-Eigenschaft angegeben werden).
  • 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