Dela via

rendera operator

  • Artikel

Gäller för: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

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

Återgivningsoperatorn måste vara den sista operatorn i frågan och kan endast användas med frågor som ger ett enda tabelldataströmresultat. Återgivningsoperatorn ä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änssnittet, kan ha stöd för olika visualiseringar.

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 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ändelsernas tidslinje (pivotering på tidsaxel)
treemap Visar hierarkiska data som en uppsättning kapslade rektanglar.

Not

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

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ä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 Beskrivning 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 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 kommer att 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

Den här visualiseringen kan utvecklas ytterligare genom att tillhandahålla egenskapen kind. 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

Flera visualiseringar används för rendering av sekvenser av värden, till exempel linechart, 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 egenskapen xcolumn. Om den inte har definierats väljer användaragenten den första kolumnen som är lämplig för visualiseringen.
    • Till exempel: i timechart visualisering använder användaragenten den första datetime kolumnen.
    • Om den här kolumnen är av typen dynamic och den 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 egenskapen ycolumns. Om den inte har definierats väljer användaragenten alla kolumner som är lämpliga för visualiseringen.
    • Till exempel: i timechart visualisering 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 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. Dessa kolumner kan anges av egenskapen series, eller så väljer användaragenten dem automatiskt från kolumnerna som annars är ospecificerade.

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