rendera operator

Växla tjänster genom att använda listrutan Version. Läs mer om navigering.
Gäller för: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Operatorn render instruerar användaragenten att visualisera frågeresultat. Det måste vara den sista operatorn i din fråga och fungerar bara med frågor som skapar en enda tabelldataström.

Operatorn ändrar inte data. I stället lägger den till en "Visualisering" -kommentar till resultatets utökade egenskaper, som innehåller visualiseringsinstruktionerna från din fråga. Olika användaragenter, till exempel Kusto.Explorer eller Azure Data Explorer webbgränssnitt, tolkar och stöder olika visualiseringar baserat på den här informationen.

Datamodellen för återgivningsoperatorn tittar på tabelldata som om den har tre typer av kolumner:

  • Kolumnen x-axeln (som anges av egenskapen xcolumn).
  • Seriekolumnerna (valfritt antal kolumner som anges av egenskapen series.) 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 egenskapen ycolumns). För varje post har serien lika många mått ("punkter" i diagrammet) som det finns y-axelkolumner.

Dricks

  • Använd where, summarize och top 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.

Not

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 Krävs Beskrivning
T string ✔️ Indatatabellens namn.
visualisering string ✔️ Anger vilken typ av visualisering 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 Beskrivning Illustration
anomalychart Liknar tidsschemat, men visar avvikelser med hjälp av funktionen series_decompose_anomalies .
areachart Ytdiagram.
barchart Visas som vågräta remsor.
card Den första resultatposten är en uppsättning skalära vä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 och andra kolumner är y-axeln.
linechart Linjediagram.
piechart Den första kolumnen är färgaxeln och den andra kolumnen är numerisk.
pivotchart Visar en pivottabell och ett diagram. Du 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-axeln och måste vara datetime. Andra (numeriska) kolumner är y-axlar.
timepivot Interaktiv navigering över händelsernas tidslinje (pivotering på tidsaxel).
treemap Visar hierarkiska data som en uppsättning kapslade rektanglar.

Not

Stegdiagram, pivotdiagram, timepivot och trädkartvisualiseringar kan användas i Kusto.Explorer men är inte tillgängliga i Azure Data Explorer webbgränssnittet.

Visualisering Beskrivning 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ärgaxeln och 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-axeln 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 Beskrivning Illustration
anomalychart Liknar tidsschemat, men visar avvikelser med hjälp av funktionen series_decompose_anomalies .
areachart Ytdiagram.
barchart Visas som vågräta remsor.
card Den första resultatposten är en uppsättning skalära vä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ärgaxeln och 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-axeln och måste vara datetime. Andra (numeriska) kolumner är y-axlar.

Egenskaper som stöds

PropertyName/PropertyValue ange ytterligare information som ska användas vid återgivning. Alla egenskaper är valfria. Egenskaperna 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 egenskap.
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 visualiseringen i flera y-axelvärden. Mer information finns i y-split egenskap.
ytitle Rubriken på y-axeln (av typen string).
anomalycolumns Egenskap som endast är relevant för anomalychart. Kommaavgränsad lista över kolumner, som betraktas som avvikelseserier och visas som punkter i diagrammet
PropertyName PropertyValue
kind Ytterligare utarbetande av visualiseringstypen. Mer information finns i kind egenskap.
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 egenskap

Du kan utveckla den här visualiseringen ytterligare genom att ange kind egenskapen . De värden som stöds för den här egenskapen är:

Visualisering kind Beskrivning
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 egenskap

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

ysplit Beskrivning
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 återges för varje ycolumn värde. Maximalt fem paneler.

Så här renderar du kontinuerliga data

Om du vill återge sekvenser av värden använder du flera visualiseringar, till exempel linechart, timechartoch areachart. Dessa visualiseringar följer den konceptuella modellen:

  • En kolumn i tabellen representerar x-axeln för data. Du kan uttryckligen definiera den här kolumnen med hjälp xcolumn av egenskapen . Om du inte definierar det väljer användaragenten den första kolumnen som fungerar för visualiseringen.
    • I visualiseringen använder till exempel timechart 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. Du kan uttryckligen definiera dessa kolumner med hjälp ycolumns av egenskapen . Om du inte definierar det väljer användaragenten alla kolumner som fungerar för visualiseringen.
    • I visualiseringen använder till exempel timechart användaragenten alla kolumner med ett numeriskt värde som du inte angav något annat.
    • Om x-axeln är en matris bör 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. Du kan ange dessa kolumner med hjälp series av egenskapen, eller så väljer användaragenten dem automatiskt från kolumnerna som annars är ospecificerade.

Relaterat innehåll

Not

Datamodellen för återgivningsoperatorn tittar på tabelldata som om den har tre typer av kolumner:

  • Kolumnen x-axeln (som anges av egenskapen xcolumn).
  • Seriekolumnerna (valfritt antal kolumner som anges av egenskapen series ).
  • Y-axelns kolumner (valfritt antal kolumner som anges av egenskapen ycolumns). 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
  • Last updated on