Operátor render
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
where
summarize
top
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|
render
vizualizace [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í, linechart
například , timechart
a 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.
- Například: ve vizualizaci
- 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.
- Například: ve vizualizaci
- 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
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro