render-Operator
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
undtop
, 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|
render
visualization [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, linechart
z. B. , timechart
und 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 erstedatetime
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.
- Beispiel: In der
- 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.
- Beispiel: In der
- 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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für