operator render

  • Artikel

Geeft de gebruikersagent de opdracht om een visualisatie van de queryresultaten weer te geven.

De renderoperator moet de laatste operator in de query zijn en kan alleen worden gebruikt met query's die één gegevensstroomresultaat in tabelvorm produceren. De renderoperator wijzigt de gegevens niet. Het injecteert een aantekening ('Visualisatie') in de uitgebreide eigenschappen van het resultaat. De aantekening bevat de informatie die door de operator in de query is opgegeven. De interpretatie van de visualisatiegegevens wordt uitgevoerd door de gebruikersagent. Verschillende agents, zoals Kusto.Explorer of de webinterface van Azure Data Explorer, kunnen verschillende visualisaties ondersteunen.

Het gegevensmodel van de renderoperator bekijkt de tabellaire gegevens alsof deze drie soorten kolommen hebben:

  • De kolom x-as (aangegeven door de xcolumn eigenschap).
  • De reekskolommen (een willekeurig aantal kolommen dat wordt aangegeven door de series eigenschap.) Voor elke record definiëren de gecombineerde waarden van deze kolommen één reeks en de grafiek heeft net zoveel reeksen als er afzonderlijke gecombineerde waarden zijn.
  • De kolommen van de y-as (een willekeurig aantal kolommen dat wordt aangegeven door de ycolumns eigenschap). Voor elke record heeft de reeks net zoveel metingen ('punten' in de grafiek) als er kolommen op de y-as zijn.

Tip

  • Gebruik whereen summarizetop om het weer te geven volume te beperken.
  • Sorteer de gegevens om de volgorde van de x-as te definiëren.
  • Gebruikersagenten kunnen de waarde 'raden' van eigenschappen die niet zijn opgegeven door de query. Met name het hebben van 'oninteresterende' kolommen in het schema van het resultaat kan zich vertalen in het verkeerd raden. Probeer dergelijke kolommen weg te projecteren wanneer dat gebeurt.

Notitie

Er zijn enkele visualisaties die alleen beschikbaar zijn in Azure Data Explorer-dashboards. Zie Dashboardspecifieke visuals voor meer informatie.

Syntax

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

Meer informatie over syntaxisconventies.

Parameters

Naam Type Vereist Beschrijving
T string ✔️ Naam van invoertabel.
Visualization string ✔️ Geeft het type visualisatie aan dat moet worden gebruikt. Moet een van de ondersteunde waarden in de volgende lijst zijn.
propertyName, propertyValue string Een door komma's gescheiden lijst met sleutel-waarde-eigenschappenparen. Zie ondersteunde eigenschappen.

Visualisatie

Visualization Description Illustratie
anomalychart Vergelijkbaar met tijddiagram, maar markeert afwijkingen met behulp van series_decompose_anomalies-functie .
areachart Vlakdiagram.
barchart weergegeven als horizontale stroken.
card De eerste resultaatrecord wordt behandeld als een reeks scalaire waarden en wordt weergegeven als een kaart.
columnchart Zoals barchart bij verticale stroken in plaats van horizontale stroken.
ladderchart De laatste twee kolommen zijn de x-as, andere kolommen zijn de y-as.
linechart Lijndiagram.
piechart De eerste kolom is een kleuras, de tweede kolom is numeriek.
pivotchart Geeft een draaitabel en grafiek weer. De gebruiker kan interactief gegevens, kolommen, rijen en verschillende grafiektypen selecteren.
scatterchart Puntengrafiek.
stackedareachart Gestapeld vlakdiagram.
table Standaard: de resultaten worden weergegeven als een tabel.
timechart Lijndiagram. De eerste kolom is een x-as en moet datum/tijd zijn. Andere (numerieke) kolommen zijn y-assen.
timepivot Interactieve navigatie over de tijdlijn van gebeurtenissen (draaien op de tijdas)
treemap Geeft hiërarchische gegevens weer als een set geneste rechthoeken.

Notitie

De visualisaties laddergrafiek, draaigrafiek, timepivot en treemap kunnen worden gebruikt in Kusto.Explorer, maar zijn niet beschikbaar in de webgebruikersinterface van Azure Data Explorer.

Visualisatie Description Illustratie
areachart Vlakdiagram. De eerste kolom is de x-as en moet een numerieke kolom zijn. Andere numerieke kolommen zijn y-assen.
barchart De eerste kolom is de x-as en kan tekst, datum/tijd of numeriek zijn. Andere kolommen zijn numeriek en worden weergegeven als horizontale stroken.
columnchart Zoals barchart bij verticale stroken in plaats van horizontale stroken.
piechart De eerste kolom is een kleuras, de tweede kolom is numeriek.
scatterchart Puntengrafiek. De eerste kolom is de x-as en moet een numerieke kolom zijn. Andere numerieke kolommen zijn y-assen.
table Standaard: de resultaten worden weergegeven als een tabel.
timechart Lijndiagram. De eerste kolom is een x-as en moet datum/tijd zijn. Andere (numerieke) kolommen zijn y-assen. Er is één tekenreekskolom waarvan de waarden worden gebruikt om de numerieke kolommen te 'groepeer' en verschillende lijnen in de grafiek te maken (andere tekenreekskolommen worden genegeerd).
Visualization Description Illustratie
anomalychart Vergelijkbaar met tijddiagram, maar markeert afwijkingen met behulp van series_decompose_anomalies-functie .
areachart Vlakdiagram.
barchart weergegeven als horizontale stroken.
card De eerste resultaatrecord wordt behandeld als een reeks scalaire waarden en wordt weergegeven als een kaart.
columnchart Zoals barchart bij verticale stroken in plaats van horizontale stroken.
linechart Lijndiagram.
piechart De eerste kolom is een kleuras, de tweede kolom is numeriek.
scatterchart Puntengrafiek.
stackedareachart Gestapeld vlakdiagram.
table Standaard: de resultaten worden weergegeven als een tabel.
timechart Lijndiagram. De eerste kolom is een x-as en moet datum/tijd zijn. Andere (numerieke) kolommen zijn y-assen.

Ondersteunde eigenschappen

Propertyname/PropertyValue geeft aanvullende informatie aan die moet worden gebruikt bij het weergeven. Alle eigenschappen zijn optioneel. De ondersteunde eigenschappen zijn:

PropertyName PropertyValue
accumulate Of de waarde van elke meting wordt toegevoegd aan alle voorafgaande waarden. (true of false)
kind Verdere uitwerking van het soort visualisatie. Zie eigenschap voor meer informatiekind.
legend Of een legenda wel of niet moet worden weergegeven (visible of hidden).
series Door komma's gescheiden lijst met kolommen waarvan de gecombineerde waarden per record de reeks definiëren waartoe de record behoort.
ymin De minimumwaarde die op de y-as moet worden weergegeven.
ymax De maximumwaarde die op de Y-as moet worden weergegeven.
title De titel van de visualisatie (van het type string).
xaxis De schaal van de x-as (linear of log).
xcolumn Welke kolom in het resultaat wordt gebruikt voor de x-as.
xtitle De titel van de x-as (van het type string).
yaxis De schaal van de y-as (linear of log).
ycolumns Door komma's gescheiden lijst met kolommen die bestaan uit de opgegeven waarden per waarde van de x-kolom.
ysplit Meerdere visualisaties splitsen. Zie eigenschap voor meer informatiey-split.
ytitle De titel van de y-as (van het type string).
anomalycolumns Eigenschap die alleen relevant is voor anomalychart. Door komma's gescheiden lijst met kolommen, die worden beschouwd als anomaliereeksen en worden weergegeven als punten in de grafiek
PropertyName PropertyValue
kind Verdere uitwerking van het soort visualisatie. Zie eigenschap voor meer informatiekind.
series Door komma's gescheiden lijst met kolommen waarvan de gecombineerde waarden per record de reeks definiëren waartoe de record behoort.
title De titel van de visualisatie (van het type string).

kind Eigenschap

Deze visualisatie kan verder worden uitgewerkt door de kind eigenschap op te geven. De ondersteunde waarden van deze eigenschap zijn:

Visualisatie kind Description
areachart default Elk "gebied" staat op zichzelf.
unstacked Hetzelfde als default.
stacked Stapel 'gebieden' aan de rechterkant.
stacked100 Stapel 'gebieden' aan de rechterkant en strek elk gebied uit tot dezelfde breedte als de andere.
barchart default Elke "bar" staat op zichzelf.
unstacked Hetzelfde als default.
stacked Stapel 'balken'.
stacked100 Stapel 'balken' en rek ze uit tot dezelfde breedte als de andere.
columnchart default Elke 'kolom' staat op zichzelf.
unstacked Hetzelfde als default.
stacked Stapel 'kolommen' boven op de andere.
stacked100 Stapel 'kolommen' en rek ze uit tot dezelfde hoogte als de andere.
scatterchart map Verwachte kolommen zijn [Lengtegraad, Breedtegraad] of GeoJSON-punt. De kolom Reeks is optioneel. Zie Georuimtelijke visualisaties voor meer informatie.
piechart map Verwachte kolommen zijn [Lengtegraad, Breedtegraad] of GeoJSON-punt, kleuras en numeriek. Ondersteund in de bureaubladversie van Kusto Explorer. Zie Georuimtelijke visualisaties voor meer informatie.

ysplit Eigenschap

Sommige visualisaties ondersteunen splitsen in meerdere y-aswaarden:

ysplit Description
none Er wordt één y-as weergegeven voor alle reeksgegevens. (standaard)
axes Eén grafiek wordt weergegeven met meerdere y-assen (één per reeks).
panels Er wordt één grafiek weergegeven voor elke ycolumn waarde (tot een bepaalde limiet).

Continue gegevens weergeven

Er worden verschillende visualisaties gebruikt voor het weergeven van reeksen van waarden, bijvoorbeeld linechart, timecharten areachart. Deze visualisaties hebben het volgende conceptuele model:

  • Eén kolom in de tabel vertegenwoordigt de x-as van de gegevens. Deze kolom kan expliciet worden gedefinieerd met behulp van de xcolumn eigenschap . Als deze niet is gedefinieerd, kiest de gebruikersagent de eerste kolom die geschikt is voor de visualisatie.
    • Bijvoorbeeld: in de timechart visualisatie gebruikt de gebruikersagent de eerste datetime kolom.
    • Als deze kolom van het type dynamic is en een matrix bevat, worden de afzonderlijke waarden in de matrix behandeld als de waarden van de x-as.
  • Een of meer kolommen in de tabel vertegenwoordigen een of meer metingen die variëren per x-as. Deze kolommen kunnen expliciet worden gedefinieerd met behulp van de ycolumns eigenschap . Als deze niet is gedefinieerd, kiest de gebruikersagent alle kolommen die geschikt zijn voor de visualisatie.
    • Bijvoorbeeld: in de timechart visualisatie gebruikt de gebruikersagent alle kolommen met een numerieke waarde die anders niet zijn opgegeven.
    • Als de x-as een matrix is, moeten de waarden van elke y-as ook een matrix van een vergelijkbare lengte zijn, waarbij elke y-as in één kolom voorkomt.
  • Nul of meer kolommen in de tabel vertegenwoordigen een unieke set dimensies die de metingen groeperen. Deze kolommen kunnen worden opgegeven door de series eigenschap, of de gebruikersagent kiest ze automatisch uit de kolommen die anders niet zijn opgegeven.

Gerelateerde inhoud

Notitie

Het gegevensmodel van de renderoperator kijkt naar de gegevens in tabelvorm alsof deze drie soorten kolommen hebben:

  • De kolom x-as (aangegeven door de xcolumn eigenschap).
  • De reekskolommen (een willekeurig aantal kolommen dat wordt aangegeven door de series eigenschap.)
  • De y-askolommen (een willekeurig aantal kolommen dat wordt aangegeven door de ycolumns eigenschap). Voor elke record heeft de reeks net zoveel metingen ('punten' in de grafiek) als er y-askolommen zijn.

Voorbeeld

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