Operátor render

Přepněte služby pomocí rozevíracího seznamu Verze . Přečtěte si další informace o navigaci.
Platí pro: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Operátor render dává uživateli pokyn, aby vizualizoval výsledky dotazu. Musí to být poslední operátor v dotazu a funguje jenom s dotazy, které vytvářejí jeden tabulkový datový proud.

Operátor neupravuje data. Místo toho přidá k rozšířeným vlastnostem výsledku poznámku Vizualizace obsahující pokyny vizualizace z dotazu. Různí uživatelé agenti, jako je Kusto.Explorer nebo Azure Data Explorer webové uživatelské rozhraní, interpretují a podporují různé vizualizace na základě těchto informací.

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

  • where Použijte summarizea 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 Typ 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.
název_nemovitosti, hodnota_vlastnosti 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 Zobrazí se jako vodorovné pruhy.
card První záznam výsledku je sada 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 a další sloupce jsou osou y.
linechart Spojnicový graf
piechart První sloupec je barevná osa a druhý sloupec je číselný.
pivotchart Zobrazí kontingenční tabulku a graf. Můžete 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éhopivotu a mapy stromové struktury lze použít v Kusto.Exploreru, ale nejsou k dispozici ve webovém uživatelském rozhraní Azure Data Explorer.

Vizualizace Popis Ilustrace
areachart Plošný graf Prvním sloupcem je osa x a měla by to být číselná hodnota. Další číselné sloupce jsou osy y.
barchart Prvním sloupcem 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 barevná osa a druhý sloupec je číselný.
scatterchart Graf bodů Prvním sloupcem je osa x a měla by to být číselná hodnota. Další číselné sloupce jsou osy y.
table Výchozí – výsledky se zobrazují jako tabulka.
timechart Spojnicový graf Prvním sloupcem 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 Zobrazí se jako vodorovné pruhy.
card První záznam výsledku je sada 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 barevná osa a 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 Rozdělení vizualizace na několik hodnot osy y 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é jsou považovány za řadu anomálií a zobrazují 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 můžete dále propracovat tím, že kind tuto vlastnost poskytnete. Podporované hodnoty pro tuto vlastnost 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. Maximálně pět panelů.

Jak vykreslit průběžná data

K vykreslení sekvencí hodnot použijte několik vizualizací, například linechart, timecharta areachart. Tyto vizualizace se řídí koncepčním modelem:

  • Jeden sloupec v tabulce představuje osu x dat. Tento sloupec můžete explicitně definovat pomocí xcolumn vlastnosti. Pokud ho nedefinujete, uživatelský agent vybere první sloupec, který bude fungovat pro vizualizaci.
    • Například ve vizualizaci timechart používá uživatelský agent první datetime sloupec.
    • Pokud je tento sloupec typu dynamic a obsahuje matici, považují se jednotlivé hodnoty v matici 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 můžete explicitně definovat pomocí ycolumns vlastnosti. Pokud ho nedefinujete, uživatelský agent vybere všechny sloupce, které fungují pro vizualizaci.
    • Například ve timechart vizualizaci používá uživatelský agent všechny sloupce s číselnou hodnotou, kterou jste nezadali 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 můžete zadat pomocí series vlastnosti nebo je uživatelský agent vybere automaticky ze sloupců, které nejsou jinak zadané.

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
  • Last updated on