renderoperator

Van toepassing op: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel-

Hiermee wordt de gebruikersagent geïnstrueerd 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 geen gegevens. Het injecteert een aantekening ('Visualisatie') in de uitgebreide eigenschappen van het resultaat. De aantekening bevat de informatie van de operator in de query. 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 kijkt naar de gegevens in tabelvorm alsof deze drie soorten kolommen bevat:

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

Fooi

• Gebruik where, summarize en top om het volume te beperken dat u weergeeft.
• Sorteer de gegevens om de volgorde van de x-as te definiëren.
• Gebruikersagents zijn vrij om de waarde te 'raden' van eigenschappen die niet door de query worden opgegeven. Het is met name mogelijk dat kolommen die niet interessant zijn, in het schema van het resultaat verkeerd worden vertaald. Probeer dergelijke kolommen weg te projecteren wanneer dat gebeurt.

Syntaxis

| render visualisatie [with(propertyName=propertyValue [, ...])]

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
T-	string	✔️	Naam van invoertabel.
visualisatie	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-eigenschapsparen. Zie ondersteunde eigenschappen.

Visualisatie

visualisatie	Beschrijving	Illustratie
anomalychart	Vergelijkbaar met het 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 set scalaire waarden en wordt weergegeven als een kaart.
columnchart	Net als barchart met verticale stroken in plaats van horizontale stroken.
linechart	Lijndiagram.
piechart	De eerste kolom is een kleuras, tweede kolom is numeriek.
scatterchart	Puntengrafiek.
stackedareachart	Gestapeld vlakdiagram.
table	Standaard: 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 aanvullende informatie aan te geven 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 taken. (true of false)
kind	Verdere uitwerking van het visualisatietype. Zie kind eigenschapvoor meer informatie.
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 bepalen waartoe de record behoort.
ymin	De minimumwaarde die moet worden weergegeven op de Y-as.
ymax	De maximumwaarde die moet worden weergegeven op de Y-as.
title	De titel van de visualisatie (van het type string).
xaxis	De x-as (linear of log) schalen.
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 y-as schalen (linear of log).
ycolumns	Door komma's gescheiden lijst met kolommen die bestaan uit de opgegeven waarden per waarde van de x-kolom.
ysplit	De visualisatie splitsen in meerdere y-aswaarden. Zie y-split eigenschapvoor meer informatie.
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 als anomaliereeks worden beschouwd en als punten in de grafiek worden weergegeven

eigenschap kind

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

visualisatie	kind	Beschrijving
areachart	default	Elk "gebied" staat op zichzelf.
	unstacked	Hetzelfde als default.
	stacked	Stapel 'gebieden' aan de rechterkant.
	stacked100	Stapel 'gebieden' aan de rechterkant en rek ze uit tot dezelfde breedte als de andere.
barchart	default	Elke 'staaf' 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 elke kolom uit tot dezelfde hoogte als de andere.
scatterchart	map	Verwachte kolommen zijn [Lengtegraad, Breedtegraad] of GeoJSON-punt. De kolom Reeks is optioneel. Zie Georuimtelijke visualisatiesvoor meer informatie.
piechart	map	Verwachte kolommen zijn [Lengtegraad, Breedtegraad] of GeoJSON-punt, kleuras en numeriek. Ondersteund in de bureaubladversie van Kusto Explorer. Zie Georuimtelijke visualisatiesvoor meer informatie.

eigenschap ysplit

Sommige visualisaties ondersteunen het splitsen in meerdere y-aswaarden:

ysplit	Beschrijving
none	Er wordt één y-as weergegeven voor alle reeksgegevens. (Standaard)
axes	Er wordt één grafiek weergegeven met meerdere y-assen (één per reeks).
panels	Eén grafiek wordt weergegeven voor elke ycolumn waarde. Maximaal vijf panelen.

Continue gegevens weergeven

Er worden verschillende visualisaties gebruikt voor het weergeven van waardenreeksen, 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 eigenschap xcolumn. 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 deze 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 eigenschap ycolumns. 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 is 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 eigenschap series of de gebruikersagent kiest deze automatisch uit de kolommen die anders niet zijn opgegeven.

Verwante inhoud

• Een queryvisualisatie toevoegen in de webgebruikersinterface
• Dashboardvisuals aanpassen
• Rendering-voorbeelden in de zelfstudie
• anomaliedetectie