Sdílet prostřednictvím

Operátor render

  • Článek

Dává uživateli pokyn, aby vykresloval vizualizaci výsledků dotazu.

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

Datový model operátoru vykreslování sleduje 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ých series vlastností)) U každého záznamu kombinované hodnoty těchto sloupců definují jednu řadu a graf má tolik řad, kolik existuje 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í ("body" v grafu), kolik je sloupců osy y.

Tip

  • summarize Použijte wherea top omezte hlasitost, kterou zobrazíte.
  • Seřaďte data a definujte pořadí osy x.
  • Uživatelskí agenti mohou "hádat" hodnotu vlastností, které nejsou zadány dotazem. Konkrétně se může stát, že mají ve schématu výsledku neinterestující sloupce, které se můžou převést do hádání chyb. Zkuste tyto sloupce projektovat, když k tomu dojde.

Poznámka:

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

Syntaxe

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

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

Parametry

Název Type Požadováno Popis
T string ✔️ Název vstupní tabulky
vizualizace string ✔️ Určuje typ vizualizace , která se má použít. Musí to být jedna z podporovaných hodnot v následujícím seznamu.
propertyName, propertyValue string Čárkami oddělený seznam párů vlastností klíč-hodnota. Viz podporované vlastnosti.

Vizualizace

vizualizace Popis Ilustrace
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 Stejně 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 osa barev, druhý sloupec je číselný.
pivotchart Zobrazí kontingenční tabulku a graf. Uživatel může interaktivně vybrat data, sloupce, řádky a různé typy grafů.
scatterchart Graf bodů
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 nad časovým řádkem událostí (otáčením na časové ose)
treemap Zobrazí hierarchická data jako sadu vnořených obdélníků.

Poznámka:

Vizualizace žebříku, kontingenčního grafu, časového limitu a mapy stromové struktury lze použít v Kusto.Exploreru, ale nejsou k dispozici ve webovém uživatelském rozhraní Azure Data Exploreru.

Vizualizace Popis Ilustrace
areachart Plošný graf První sloupec je osa x a měla by se jednat o číselný sloupec. Další číselné sloupce jsou osy y.
barchart První sloupec je osa 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 Stejně jako barchart u svislých pruhů místo vodorovných pruhů.
piechart První sloupec je osa barev, druhý sloupec je číselný.
scatterchart Graf bodů První sloupec je osa x a měla by se jednat o číselný sloupec. Další číselné sloupce jsou osy y.
table Výchozí – výsledky se zobrazují jako tabulka.
timechart Spojnicový graf První sloupec je osa x a měla by být datetime. Ostatní (číselné) sloupce jsou osy y. Existuje jeden řetězcový sloupec, jehož hodnoty se používají k seskupení číselných sloupců a vytvoření různých čar v grafu (další řetězcové sloupce se ignorují).
vizualizace Popis Ilustrace
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 Stejně jako barchart u svislých pruhů místo vodorovných pruhů.
linechart Spojnicový graf
piechart První sloupec je osa barev, druhý sloupec je číselný.
scatterchart Graf bodů
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:

PropertyName PropertyValue
accumulate Určuje, jestli se hodnota každé míry přidá ke všem svým předchůdcům. (true nebo false)
kind Další zpracování druhu vizualizace. Další informace naleznete 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 záznam 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žívá 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 pro hodnotu sloupce x.
ysplit Jak rozdělit více vizualizací Další informace naleznete v tématu y-split vlastnost.
ytitle Název osy y (typu string).
anomalycolumns Vlastnost relevantní pouze pro anomalychart. Čárkami oddělený seznam sloupců, které budou považovány za řadu anomálií a zobrazí se jako body v grafu.
PropertyName PropertyValue
kind Další zpracování druhu vizualizace. Další informace naleznete v tématu kind vlastnost.
series Seznam sloupců oddělených čárkami, jejichž kombinované hodnoty pro záznam definují řadu, do které záznam patří.
title Název vizualizace (typu string).

kind vlastnost

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

Vizualizace kind Popis
areachart default Každá "oblast" stojí samostatně.
unstacked Stejné jako default.
stacked Naskládat "oblasti" doprava.
stacked100 Naskládání "oblastí" doprava a roztažení každého z nich na stejnou šířku jako ostatní.
barchart default Každý "bar" stojí samostatně.
unstacked Stejné jako default.
stacked Stack "bars".
stacked100 Naskládání "pruhů" a jejich roztažení na stejnou šířku jako ostatní.
columnchart default Každý "sloupec" stojí samostatně.
unstacked Stejné jako default.
stacked Stack "columns" jeden na druhé.
stacked100 Naskládání "sloupců" a jejich roztažení na stejnou výšku jako ostatní.
scatterchart map Očekávané sloupce jsou [Zeměpisná délka, zeměpisná šířka] nebo bod GeoJSON. Sloupec řady 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, osa barev a číselné hodnoty. Podporováno v desktopové verzi Kusto Exploreru. Další informace najdete v tématu Geoprostorové vizualizace.

ysplit vlastnost

Některé vizualizace podporují rozdělení na několik hodnot osy y:

ysplit Popis
none Pro všechna data řad se zobrazí jedna osa y. (Výchozí)
axes Jeden graf se zobrazí s více osami y (jedna na řadu).
panels Jeden graf se vykreslí pro každou ycolumn hodnotu (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í definovaný, uživatelský agent vybere první sloupec, který je vhodný pro vizualizaci.
    • Například: ve timechart vizualizaci používá uživatelský agent první datetime sloupec.
    • Pokud je tento sloupec typu dynamic a obsahuje matici, 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ší osou x. Tyto sloupce lze explicitně definovat pomocí ycolumns vlastnosti. Pokud není definovaný, uživatelský agent vybere všechny sloupce vhodné pro vizualizaci.
    • Příklad: Ve timechart vizualizaci používá uživatelský agent všechny sloupce s číselnou hodnotou, která nebyla zadána jinak.
    • Pokud je osa x matice, hodnoty každé osy y by měly 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 dohromady. Tyto sloupce mohou být zadány series vlastností, nebo je uživatelský agent vybere automaticky ze sloupců, které nejsou jinak zadány.

Související obsah

Poznámka:

Datový model operátoru vykreslování sleduje 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ý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í ("body" 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