Operátor render

  • Článek

Dá uživatelskému agentovi pokyn, aby vykresloval vizualizaci výsledků dotazu.

Operátor vykreslení musí být posledním operátorem v dotazu a lze ho použít pouze s dotazy, které vygenerují jeden výsledek tabulkového datového streamu. Operátor vykreslení data neupravuje. Vloží poznámku ("Visualization") do rozšířených vlastností výsledku. Poznámka obsahuje informace poskytnuté operátorem v dotazu. Interpretaci informací vizualizace provádí uživatelský agent. Různé vizualizace můžou podporovat různí agenti, jako je Kusto.Explorer nebo webové uživatelské rozhraní Azure Data Explorer.

Datový model operátoru vykreslení se dívá na tabulková data, jako by měl tři druhy sloupců:

  • Sloupec osy X (označený xcolumn vlastností)
  • Sloupce řad (libovolný počet sloupců označený series vlastností) Kombinované hodnoty těchto sloupců definují pro každý záznam jednu řadu a graf má tolik řad, kolik je jedinečných kombinovaných hodnot.
  • Sloupce osy y (libovolný počet sloupců označených ycolumns vlastností). Pro každý záznam má řada tolik měření ("bodů" v grafu), kolik je sloupců osy y.

Tip

  • Pomocí a wheresummarizetop omezte hlasitost, kterou zobrazíte.
  • Řazením dat můžete definovat pořadí osy X.
  • Uživatelskí agenti mohou "odhadnout" hodnotu vlastností, které nejsou určeny dotazem. Konkrétně pokud máte ve schématu výsledku "nezajímavé" sloupce, může se stát, že hádají špatně. Když k tomu dojde, zkuste takové sloupce promítnout.

Poznámka

Některé vizualizace jsou dostupné jenom na řídicích panelech Azure Data Explorer. Další informace najdete v tématu Vizuály specifické pro řídicí panel.

Syntax

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

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název Typ Vyžadováno Popis
T string ✔️ Zadejte název tabulky.
Vizualizace string ✔️ Označuje druh vizualizace , která se má použít. Musí to být jedna z podporovaných hodnot v následujícím seznamu.
propertyName, propertyValue string Seznam párů vlastností klíč-hodnota oddělený čárkami. Projděte si podporované vlastnosti.

Vizualizace

Vizualizace Description Obrázek
anomalychart Podobá se časovému diagramu, ale zvýrazňuje anomálie pomocí funkce series_decompose_anomalies .
areachart Plošný graf.
barchart zobrazené jako vodorovné pruhy.
card První záznam výsledku se považuje za sadu skalárních hodnot a zobrazuje se jako karta.
columnchart Jako barchart u svislých pruhů místo vodorovných pruhů.
ladderchart Poslední dva sloupce jsou osou X, ostatní sloupce jsou osou y.
linechart Spojnicový graf.
piechart První sloupec je barevná osa, druhý sloupec je číselný.
pivotchart Zobrazí kontingenční tabulku a graf. Uživatel může interaktivně vybírat data, sloupce, řádky a různé typy grafů.
scatterchart Bodové grafy
stackedareachart Skládaný plošný graf.
table Výchozí – výsledky se zobrazují jako tabulka.
timechart Spojnicový graf. První sloupec je osa X a musí být datetime. Ostatní (číselné) sloupce jsou osy y.
timepivot Interaktivní navigace přes časovou osu událostí (otáčení na časové ose)
treemap Zobrazí hierarchická data jako sadu vnořených obdélníků.

Poznámka

Vizualizace žebříkového grafu, kontingenčního grafu, časového doplňku a mapy stromové struktury je možné použít v Nástroji Kusto.Explorer, ale nejsou k dispozici ve webovém uživatelském rozhraní Azure Data Explorer.

Vizualizace Description Obrázek
areachart Plošný graf. První sloupec je na ose X a měl by to být číselný sloupec. Ostatní číselné sloupce jsou osy y.
barchart První sloupec je osou X a může to být text, datum a čas nebo číselná hodnota. Ostatní sloupce jsou číselné a zobrazují se jako vodorovné pruhy.
columnchart Jako barchart u svislých pruhů místo vodorovných pruhů.
piechart První sloupec je barevná osa, druhý sloupec je číselný.
scatterchart Bodové grafy První sloupec je na ose X a měl by to být číselný sloupec. Ostatní číselné sloupce jsou osy y.
table Výchozí – výsledky se zobrazují jako tabulka.
timechart Spojnicový graf. První sloupec je osa X a měl by být datetime. Ostatní (číselné) sloupce jsou osy y. Existuje jeden sloupec řetězce, jehož hodnoty se použijí k "seskupení" číselných sloupců a vytvoření různých čar v grafu (další sloupce řetězců se ignorují).
Vizualizace Description Obrázek
anomalychart Podobá se časovému diagramu, ale zvýrazňuje anomálie pomocí funkce series_decompose_anomalies .
areachart Plošný graf.
barchart zobrazené jako vodorovné pruhy.
card První záznam výsledku se považuje za sadu skalárních hodnot a zobrazuje se jako karta.
columnchart Jako barchart u svislých pruhů místo vodorovných pruhů.
linechart Spojnicový graf.
piechart První sloupec je barevná osa, druhý sloupec je číselný.
scatterchart Bodové grafy
stackedareachart Skládaný plošný graf.
table Výchozí – výsledky se zobrazují jako tabulka.
timechart Spojnicový graf. První sloupec je osa X a musí být datetime. Ostatní (číselné) sloupce jsou osy y.

Podporované vlastnosti

Propertyname/PropertyValue označuje další informace, které se mají použít při vykreslování. Všechny vlastnosti jsou volitelné. Podporované vlastnosti jsou:

PropertyName Propertyvalue
accumulate Určuje, jestli se hodnota jednotlivých měr přičte ke všem svým předchůdcům. (true nebo false)
kind Další zpracování vizualizačního typu. Další informace najdete v tématu kind vlastnost.
legend Zda se má zobrazit legenda nebo ne (visible nebo hidden).
series Seznam sloupců oddělených čárkami, jejichž kombinované hodnoty pro jednotlivé záznamy definují řadu, do které záznam patří.
ymin Minimální hodnota, která se má zobrazit na ose Y.
ymax Maximální hodnota, která se má zobrazit na ose Y.
title Název vizualizace (typu string).
xaxis Jak škálovat osu x (linear nebo log).
xcolumn Který sloupec ve výsledku se použije pro osu x.
xtitle Název osy x (typu string).
yaxis Jak škálovat osu y (linear nebo log).
ycolumns Seznam sloupců oddělených čárkami, které se skládají z hodnot zadaných podle hodnoty sloupce x.
ysplit Jak rozdělit více vizualizací. Další informace najdete v tématu y-split vlastnost.
ytitle Název osy y (typu string).
anomalycolumns Vlastnost relevantní pouze pro anomalychart. Seznam sloupců oddělených čárkami, který se bude považovat za řadu anomálií a zobrazí se jako body v grafu.
PropertyName Propertyvalue
kind Další zpracování vizualizačního typu. Další informace najdete v tématu kind vlastnost.
series Seznam sloupců oddělených čárkami, jejichž kombinované hodnoty pro jednotlivé záznamy definují řadu, do které záznam patří.
title Název vizualizace (typu string).

kind Vlastnost

Tuto vizualizaci je možné dále rozpracovat poskytnutím kind vlastnosti. Podporované hodnoty této vlastnosti jsou:

Vizualizace kind Description
areachart default Každá "oblast" stojí sama o sobě.
unstacked Stejné jako default.
stacked Napravo posadíte "oblasti".
stacked100 Posadte "oblasti" doprava a roztáhněte je na stejnou šířku jako ostatní.
barchart default Každý "pruh" stojí sám o sobě.
unstacked Stejné jako default.
stacked Zásobník "pruhů".
stacked100 Posadíte "pruhy" a roztáhněte je na stejnou šířku jako ostatní.
columnchart default Každý "sloupec" stojí sám o sobě.
unstacked Stejné jako default.
stacked Naskládejte "sloupce" jeden nad druhým.
stacked100 Naskládejte "sloupce" a roztáhněte je do stejné výšky jako ostatní.
scatterchart map Očekávané sloupce jsou [zeměpisná délka, zeměpisná šířka] nebo bod GeoJSON. Sloupec Series (Řada) je volitelný. Další informace najdete v tématu Geoprostorové vizualizace.
piechart map Očekávané sloupce jsou [zeměpisná délka, zeměpisná šířka] nebo bod GeoJSON, barevná osa a číselná čísla. Podporováno v desktopové verzi Kusto Exploreru. Další informace najdete v tématu Geoprostorové vizualizace.

ysplit Vlastnost

Některé vizualizace podporují rozdělení na více hodnot osy Y:

ysplit Description
none Pro všechna data řad se zobrazí jedna osa y. (Výchozí)
axes Jeden graf se zobrazí s několika osami y (jedna na řadu).
panels Pro každou ycolumn hodnotu se vykreslí jeden graf (až do určitého limitu).

Jak vykreslit průběžná data

Pro vykreslování sekvencí hodnot se používá několik vizualizací, linechartnapříklad , timecharta areachart. Tyto vizualizace mají následující koncepční model:

  • Jeden sloupec v tabulce představuje osu X dat. Tento sloupec lze explicitně definovat pomocí xcolumn vlastnosti . Pokud není definován, vybere uživatelský agent první sloupec, který je vhodný pro vizualizaci.
    • Například: ve vizualizaci timechart používá uživatelský agent první datetime sloupec.
    • Pokud je tento sloupec typu dynamic a obsahuje pole, budou jednotlivé hodnoty v matici považovány za hodnoty osy x.
  • Jeden nebo více sloupců v tabulce představuje jednu nebo více měr, které se liší podle osy x. Tyto sloupce lze explicitně definovat pomocí ycolumns vlastnosti . Pokud není definován, vybere uživatelský agent všechny sloupce, které jsou vhodné pro vizualizaci.
    • Například: ve vizualizaci timechart použije uživatelský agent všechny sloupce s číselnou hodnotou, která nebyla zadána jinak.
    • Pokud je osa x matice, měly by hodnoty každé osy y být také matice podobné délky, přičemž každá osa y se vyskytuje v jednom sloupci.
  • Nula nebo více sloupců v tabulce představuje jedinečnou sadu dimenzí, které seskupují míry. Tyto sloupce mohou být určeny series vlastností nebo je uživatelský agent vybere automaticky ze sloupců, které jsou jinak neurčené.

Související obsah

Poznámka

Datový model operátoru vykreslování se na tabulková data dívá, jako by měl tři druhy sloupců:

  • Sloupec osy x (označený xcolumn vlastností)
  • Sloupce řad (libovolný počet sloupců označených series vlastností)
  • Sloupce osy y (libovolný počet sloupců označených ycolumns vlastností) Pro každý záznam má řada tolik měření ("bodů" v grafu), kolik je sloupců osy y.

Příklad

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