Dela via

render-operatorn

  • Artikel

Instruerar användaragenten att rendera en visualisering av frågeresultatet.

Renderningsoperatorn måste vara den sista operatorn i frågan och kan bara användas med frågor som genererar ett enda dataströmresultat i tabellform. Renderingsoperatorn ändrar inte data. Den matar in en anteckning ("Visualisering") i resultatets utökade egenskaper. Kommentaren innehåller den information som tillhandahålls av operatorn i frågan. Tolkningen av visualiseringsinformationen görs av användaragenten. Olika agenter, till exempel Kusto.Explorer eller Azure Data Explorer webbgränssnitt, kan ha stöd för olika visualiseringar.

Återgivningsoperatorns datamodell tittar på tabelldata som om den har tre typer av kolumner:

  • X-axelns kolumn (anges av xcolumn egenskapen ).
  • Seriekolumnerna (valfritt antal kolumner som anges av series egenskapen.) För varje post definierar de kombinerade värdena för dessa kolumner en enda serie, och diagrammet har lika många serier som det finns distinkta kombinerade värden.
  • Y-axelns kolumner (valfritt antal kolumner som anges av ycolumns egenskapen ). För varje post har serien lika många mått ("punkter" i diagrammet) som det finns y-axelkolumner.

Tips

  • Använd whereoch summarizetop för att begränsa den volym som du visar.
  • Sortera data för att definiera ordningen på x-axeln.
  • Användaragenter kan "gissa" värdet för egenskaper som inte anges av frågan. I synnerhet kan "ointressanta" kolumner i schemat för resultatet översättas till att de gissar fel. Prova att projicera bort sådana kolumner när det händer.

Anteckning

Det finns vissa visualiseringar som bara är tillgängliga i Azure Data Explorer instrumentpaneler. Mer information finns i Instrumentpanelsspecifika visuella objekt.

Syntax

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

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Obligatorisk Beskrivning
T string ✔️ Namn på indatatabell.
Visualisering string ✔️ Anger vilken typ av visualisering som ska användas. Måste vara ett av de värden som stöds i följande lista.
propertyName, propertyValue string En kommaavgränsad lista över nyckel/värde-egenskapspar. Se egenskaper som stöds.

Visualisering

Visualisering Description Illustration
anomalychart Liknar tidsschemat, men visar avvikelser med hjälp av series_decompose_anomalies funktion.
areachart Ytdiagram.
barchart visas som vågräta remsor.
card Den första resultatposten behandlas som en uppsättning skalärvärden och visas som ett kort.
columnchart Som barchart med lodräta remsor i stället för vågräta remsor.
ladderchart De två sista kolumnerna är x-axeln, andra kolumner är y-axeln.
linechart Linjediagram.
piechart Den första kolumnen är färgaxel, den andra kolumnen är numerisk.
pivotchart Visar en pivottabell och ett diagram. Användaren kan interaktivt välja data, kolumner, rader och olika diagramtyper.
scatterchart Punktdiagram.
stackedareachart Staplad ytgraf.
table Standard – resultaten visas som en tabell.
timechart Linjediagram. Den första kolumnen är x-axel och måste vara datetime. Andra (numeriska) kolumner är y-axlar.
timepivot Interaktiv navigering över händelsetidslinjen (pivotering på tidsaxeln)
treemap Visar hierarkiska data som en uppsättning kapslade rektanglar.

Anteckning

Visualiseringarna ladderchart, pivotchart, timepivot och treemap kan användas i Kusto.Explorer men är inte tillgängliga i webbgränssnittet för Azure Data Explorer.

Visualisering Description Illustration
areachart Ytdiagram. Den första kolumnen är x-axeln och bör vara en numerisk kolumn. Andra numeriska kolumner är y-axlar.
barchart Den första kolumnen är x-axeln och kan vara text, datetime eller numerisk. Andra kolumner är numeriska och visas som vågräta remsor.
columnchart Som barchart med lodräta remsor i stället för vågräta remsor.
piechart Den första kolumnen är färgaxel, den andra kolumnen är numerisk.
scatterchart Punktdiagram. Den första kolumnen är x-axeln och bör vara en numerisk kolumn. Andra numeriska kolumner är y-axlar.
table Standard – resultaten visas som en tabell.
timechart Linjediagram. Den första kolumnen är x-axel och bör vara datetime. Andra (numeriska) kolumner är y-axlar. Det finns en strängkolumn vars värden används för att "gruppera" de numeriska kolumnerna och skapa olika rader i diagrammet (ytterligare strängkolumner ignoreras).
Visualisering Description Illustration
anomalychart Liknar tidsschemat, men visar avvikelser med hjälp av series_decompose_anomalies funktion.
areachart Ytdiagram.
barchart visas som vågräta remsor.
card Den första resultatposten behandlas som en uppsättning skalärvärden och visas som ett kort.
columnchart Som barchart med lodräta remsor i stället för vågräta remsor.
linechart Linjediagram.
piechart Den första kolumnen är färgaxel, den andra kolumnen är numerisk.
scatterchart Punktdiagram.
stackedareachart Staplad ytgraf.
table Standard – resultaten visas som en tabell.
timechart Linjediagram. Den första kolumnen är x-axel och måste vara datetime. Andra (numeriska) kolumner är y-axlar.

Egenskaper som stöds

PropertyName/PropertyValue anger ytterligare information som ska användas vid återgivning. Alla egenskaper är valfria. De egenskaper som stöds är:

PropertyName PropertyValue
accumulate Om värdet för varje mått läggs till i alla dess föregångare. (true eller false)
kind Ytterligare utarbetande av visualiseringstypen. Mer information finns i kind egenskapen .
legend Om du vill visa en förklaring eller inte (visible eller hidden).
series Kommaavgränsad lista över kolumner vars kombinerade värden per post definierar den serie som posten tillhör.
ymin Det minsta värde som ska visas på Y-axeln.
ymax Det maximala värdet som ska visas på Y-axeln.
title Visualiseringens rubrik (av typen string).
xaxis Så här skalar du x-axeln (linear eller log).
xcolumn Vilken kolumn i resultatet som används för x-axeln.
xtitle Rubriken på x-axeln (av typen string).
yaxis Skala y-axeln (linear eller log).
ycolumns Kommaavgränsad lista över kolumner som består av de värden som anges per värde i x-kolumnen.
ysplit Så här delar du upp flera visualiseringar. Mer information finns i y-split egenskapen .
ytitle Rubriken på y-axeln (av typen string).
anomalycolumns Egenskapen är endast relevant för anomalychart. Kommaavgränsad lista över kolumner, som kommer att betraktas som avvikelseserier och visas som punkter i diagrammet
PropertyName PropertyValue
kind Ytterligare utarbetande av visualiseringstypen. Mer information finns i kind egenskapen .
series Kommaavgränsad lista över kolumner vars kombinerade värden per post definierar den serie som posten tillhör.
title Visualiseringens rubrik (av typen string).

kind Egenskapen

Den här visualiseringen kan utvecklas ytterligare genom att tillhandahålla kind egenskapen . De värden som stöds för den här egenskapen är:

Visualisering kind Description
areachart default Varje "område" står på egen hand.
unstacked Samma som default.
stacked Stapla "områden" till höger.
stacked100 Stapla "områden" till höger och sträck ut var och en till samma bredd som de andra.
barchart default Varje "bar" står på egen hand.
unstacked Samma som default.
stacked Stapla "staplar".
stacked100 Stapla "staplar" och sträck ut var och en till samma bredd som de andra.
columnchart default Varje "kolumn" står på egen hand.
unstacked Samma som default.
stacked Stapla "kolumner" ovanpå varandra.
stacked100 Stapla "kolumner" och sträck ut var och en till samma höjd som de andra.
scatterchart map Förväntade kolumner är [Longitud, Latitud] eller GeoJSON-punkt. Seriekolumnen är valfri. Mer information finns i Geospatiala visualiseringar.
piechart map Förväntade kolumner är [Longitud, Latitud] eller GeoJSON-punkt, färgaxel och numerisk. Stöds i Kusto Explorer Desktop. Mer information finns i Geospatiala visualiseringar.

ysplit Egenskapen

Vissa visualiseringar stöder delning i flera y-axelvärden:

ysplit Description
none En enda y-axel visas för alla seriedata. Standard
axes Ett enskilt diagram visas med flera y-axlar (en per serie).
panels Ett diagram renderas för varje ycolumn värde (upp till en viss gräns).

Så här renderar du kontinuerliga data

Flera visualiseringar används för återgivning av sekvenser med värden, linecharttill exempel , timechartoch areachart. Dessa visualiseringar har följande konceptuella modell:

  • En kolumn i tabellen representerar x-axeln för data. Den här kolumnen kan definieras explicit med hjälp av xcolumn egenskapen . Om den inte har definierats väljer användaragenten den första kolumnen som är lämplig för visualiseringen.
    • Exempel: i timechart visualiseringen använder användaragenten den första datetime kolumnen.
    • Om den här kolumnen är av typen dynamic och innehåller en matris behandlas de enskilda värdena i matrisen som värden för x-axeln.
  • En eller flera kolumner i tabellen representerar ett eller flera mått som varierar beroende på x-axeln. Dessa kolumner kan definieras explicit med hjälp av ycolumns egenskapen . Om den inte har definierats väljer användaragenten alla kolumner som är lämpliga för visualiseringen.
    • Till exempel: i timechart visualiseringen använder användaragenten alla kolumner med ett numeriskt värde som inte har angetts på annat sätt.
    • Om x-axeln är en matris ska värdena för varje y-axel också vara en matris med liknande längd, där varje y-axel förekommer i en enda kolumn.
  • Noll eller fler kolumner i tabellen representerar en unik uppsättning dimensioner som grupperar måtten. Dessa kolumner kan anges av series egenskapen eller så väljer användaragenten dem automatiskt från kolumnerna som annars är ospecificerade.

Relaterat innehåll

Anteckning

Återgivningsoperatorns datamodell tittar på tabelldata som om den har tre typer av kolumner:

  • X-axelns kolumn (anges av xcolumn egenskapen ).
  • Seriekolumnerna (valfritt antal kolumner som anges av series egenskapen.)
  • Y-axelns kolumner (valfritt antal kolumner som anges av ycolumns egenskapen ). För varje post har serien lika många mått ("punkter" i diagrammet) som det finns y-axelkolumner.

Exempel

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