render operátor
Utasítja a felhasználói ügynököt, hogy renderelje a lekérdezési eredmények vizualizációját.
A renderelési operátornak kell lennie a lekérdezés utolsó operátorának, és csak olyan lekérdezésekkel használható, amelyek egyetlen táblázatos adatfolyam-eredményt hoznak létre. A renderelési operátor nem módosítja az adatokat. Széljegyzetet ("vizualizációt") szúr be az eredmény bővített tulajdonságaiba. A széljegyzet tartalmazza az operátor által a lekérdezésben megadott információkat. A vizualizációs információk értelmezését a felhasználói ügynök végzi. A különböző ügynökök, például a Kusto.Explorer vagy az Azure Data Explorer webes felhasználói felülete különböző vizualizációkat támogathatnak.
A renderelési operátor adatmodellje úgy tekinti meg a táblázatos adatokat, mintha háromféle oszlopból áll:
- Az x tengely oszlopa (amelyet a
xcolumn
tulajdonság jelez). - Az adatsoroszlopok (tetszőleges számú oszlop, amelyet a
series
tulajdonság jelöl.) Minden rekordhoz ezeknek az oszlopoknak az együttes értékei egyetlen adatsort határoznak meg, és a diagram annyi adatsort tartalmaz, amennyit különböző kombinált értékek is tartalmaznak. - Az y tengely oszlopai (a tulajdonság által
ycolumns
jelzett tetszőleges számú oszlop). Az adatsor minden rekordhoz annyi mérést ("pontot" tartalmaz a diagramban), mint az y tengelyes oszlopok.
Tipp
summarize
top
A és a használatávalwhere
korlátozhatja a megjelenített kötetet.- Rendezze az adatokat az x tengely sorrendjének meghatározásához.
- A felhasználói ügynökök szabadon "találgatják" a lekérdezés által nem megadott tulajdonságok értékét. Különösen, ha az eredmény sémájában "érdektelen" oszlopok vannak, előfordulhat, hogy helytelenül találgatnak. Ilyen esetekben próbálja meg kivetíteni az ilyen oszlopokat.
Megjegyzés
Vannak olyan vizualizációk, amelyek csak az Azure Data Explorer irányítópultokon érhetők el. További információ: Irányítópult-specifikus vizualizációk.
Syntax
T|
render
vizualizáció [with
(
propertyName=
propertyValue [,
...])
]
További információ a szintaxis konvenciókról.
Paraméterek
Név | Típus | Kötelező | Leírás |
---|---|---|---|
T | string |
✔️ | Bemeneti tábla neve. |
Vizualizáció | string |
✔️ | A használni kívánt vizualizációtípust jelzi. Az alábbi lista egyik támogatott értékének kell lennie. |
propertyName, propertyValue | string |
Kulcs-érték tulajdonságpárok vesszővel tagolt listája. Lásd a támogatott tulajdonságokat. |
Vizualizáció
Vizualizáció | Description | Illusztráció |
---|---|---|
anomalychart |
Hasonló az idődiagramhoz, de kiemeli az anomáliákatseries_decompose_anomalies függvénnyel. | |
areachart |
Területdiagram. | |
barchart |
vízszintes csíkként jelenik meg. | |
card |
Az első eredményrekord skaláris értékek halmazaként lesz kezelve, és kártyaként jelenik meg. | |
columnchart |
Mint barchart a függőleges csíkok helyett vízszintes csíkok. |
|
ladderchart |
Az utolsó két oszlop az x tengely, a többi pedig az y tengely. | |
linechart |
Vonaldiagram. | |
piechart |
Az első oszlop színtengely, a második oszlop numerikus. | |
pivotchart |
Kimutatástáblát és diagramot jelenít meg. A felhasználó interaktív módon választhat ki adatokat, oszlopokat, sorokat és különböző diagramtípusokat. | |
scatterchart |
Pontdiagram. | |
stackedareachart |
Halmozott területdiagram. | |
table |
Alapértelmezett – az eredmények táblázatként jelennek meg. | |
timechart |
Vonaldiagram. Az első oszlop x tengelyű, és dátum/idő típusúnak kell lennie. Más (numerikus) oszlopok y tengelyek. | |
timepivot |
Interaktív navigáció az események idővonalán (az időtengelyen történő forgatás) | |
treemap |
Hierarchikus adatokat jelenít meg beágyazott téglalapok halmazaként. |
Megjegyzés
A létradiagram, a kimutatásdiagram, a timepivot és a fatérkép vizualizációk használhatók a Kusto.Explorerben, de nem érhetők el az Azure Data Explorer webes felhasználói felületén.
Vizualizáció | Description | Illusztráció |
---|---|---|
areachart |
Területdiagram. Az első oszlop az x tengely, és numerikus oszlopnak kell lennie. Más numerikus oszlopok y tengelyek. | |
barchart |
Az első oszlop az x tengely, amely lehet szöveg, dátum/idő vagy numerikus. A többi oszlop numerikus, vízszintes csíkként jelenik meg. | |
columnchart |
Mint barchart a függőleges csíkok helyett vízszintes csíkok. |
|
piechart |
Az első oszlop színtengely, a második oszlop numerikus. | |
scatterchart |
Pontdiagram. Az első oszlop az x tengely, és numerikus oszlopnak kell lennie. Más numerikus oszlopok y tengelyek. | |
table |
Alapértelmezett – az eredmények táblázatként jelennek meg. | |
timechart |
Vonaldiagram. Az első oszlop x tengelyű, és dátum/idő típusúnak kell lennie. Más (numerikus) oszlopok y tengelyek. Van egy sztringoszlop, amelynek értékei a numerikus oszlopok "csoportosítására" és a diagram különböző sorainak létrehozására szolgálnak (a további sztringoszlopok figyelmen kívül lesznek hagyva). |
Vizualizáció | Description | Illusztráció |
---|---|---|
anomalychart |
Hasonló az idődiagramhoz, de kiemeli az anomáliákatseries_decompose_anomalies függvénnyel. | |
areachart |
Területdiagram. | |
barchart |
vízszintes csíkként jelenik meg. | |
card |
Az első eredményrekord skaláris értékek halmazaként lesz kezelve, és kártyaként jelenik meg. | |
columnchart |
Mint barchart a függőleges csíkok helyett vízszintes csíkok. |
|
linechart |
Vonaldiagram. | |
piechart |
Az első oszlop színtengely, a második oszlop numerikus. | |
scatterchart |
Pontdiagram. | |
stackedareachart |
Halmozott területdiagram. | |
table |
Alapértelmezett – az eredmények táblázatként jelennek meg. | |
timechart |
Vonaldiagram. Az első oszlop x tengelyű, és dátum/idő típusúnak kell lennie. Más (numerikus) oszlopok y tengelyek. |
Támogatott tulajdonságok
PropertyName/A PropertyValue a renderelés során használandó további információkat jelzi. Az összes tulajdonság megadása nem kötelező. A támogatott tulajdonságok a következők:
PropertyName | PropertyValue |
---|---|
accumulate |
Azt határozza meg, hogy az egyes mértékek értéke hozzá legyen-e adva az összes elődjéhez. (true vagy false ) |
kind |
A vizualizáció típusának további kidolgozása. További információ: kind tulajdonság. |
legend |
Megjeleníthet-e jelmagyarázatot vagy sem (visible vagy hidden ). |
series |
Azoknak az oszlopoknak a vessző által tagolt listája, amelyek rekordonkénti összesített értékei határozzák meg azt az adatsort, amelyhez a rekord tartozik. |
ymin |
Az Y tengelyen megjelenítendő minimális érték. |
ymax |
Az Y tengelyen megjelenítendő maximális érték. |
title |
A vizualizáció címe (típus string ). |
xaxis |
Az x tengely (linear vagy log ) skálázása |
xcolumn |
Az eredmény melyik oszlopát használja a rendszer az x tengelyhez. |
xtitle |
Az x tengely címe (típus string ). |
yaxis |
Az y tengely skálázása (linear vagy log ). |
ycolumns |
Az x oszlop értékeként megadott értékekből álló oszlopok vessző által tagolt listája. |
ysplit |
Több vizualizáció felosztása. További információ: y-split tulajdonság. |
ytitle |
Az y tengely címe (típus string ). |
anomalycolumns |
A tulajdonság csak a esetében anomalychart releváns. Oszlopok vesszővel tagolt listája, amely anomáliadetektúra-sorozatnak minősül, és pontokként jelenik meg a diagramon |
PropertyName | PropertyValue |
---|---|
kind |
A vizualizáció típusának további kidolgozása. További információ: kind tulajdonság. |
series |
Azoknak az oszlopoknak a vessző által tagolt listája, amelyek rekordonkénti összesített értékei határozzák meg azt az adatsort, amelyhez a rekord tartozik. |
title |
A vizualizáció címe (típus string ). |
kind
Tulajdonság
Ez a vizualizáció tovább részletezhető a kind
tulajdonság megadásával.
A tulajdonság támogatott értékei a következők:
Vizualizáció | kind |
Description |
---|---|---|
areachart |
default |
Minden "terület" önállóan áll. |
unstacked |
Ugyanaz, mint a default . |
|
stacked |
Verem "területek" a jobb oldalon. | |
stacked100 |
Verem "területek" a jobb oldalon, és nyújtsa az egyeseket, hogy azonos szélességű, mint a többi. | |
barchart |
default |
Minden "bár" önállóan áll. |
unstacked |
Ugyanaz, mint a default . |
|
stacked |
Verem "sávok". | |
stacked100 |
Verem "sávok", és nyújtsd mindegyik ugyanolyan szélességű, mint a többi. | |
columnchart |
default |
Minden "oszlop" önmagában áll. |
unstacked |
Ugyanaz, mint a default . |
|
stacked |
Verem "oszlopok" az egyik tetején a másik. | |
stacked100 |
Az "oszlopok" halmozása és az egyes oszlopok kinyújtása a többiével megegyező magasságban. | |
scatterchart |
map |
A várt oszlopok a következők: [Hosszúság, Szélesség] vagy GeoJSON-pont. Az Adatsor oszlop megadása nem kötelező. További információ: Térinformatikai vizualizációk. |
piechart |
map |
A várt oszlopok a következők: [Hosszúság, Szélesség] vagy GeoJSON-pont, színtengely és numerikus. A Kusto Explorer asztali verziójában támogatott. További információ: Térinformatikai vizualizációk. |
ysplit
Tulajdonság
Egyes vizualizációk több y tengelyes értékre való felosztást támogatnak:
ysplit |
Description |
---|---|
none |
Minden adatsorhoz egyetlen y tengely jelenik meg. (Alapértelmezett) |
axes |
Egyetlen diagram több y tengelyrel (sorozatonként egy) jelenik meg. |
panels |
Minden ycolumn értékhez egy diagram jelenik meg (legfeljebb néhány korlátig). |
Folyamatos adatok renderelése
Számos vizualizációt használunk értéksorozatok megjelenítéséhez, például, linechart
, timechart
és areachart
.
Ezek a vizualizációk a következő fogalmi modellel rendelkeznek:
- A táblázat egyik oszlopa az adatok x tengelyét jelöli. Ez az oszlop explicit módon definiálható a
xcolumn
tulajdonság használatával. Ha nincs definiálva, a felhasználói ügynök kiválasztja a vizualizációnak megfelelő első oszlopot.- Például: a
timechart
vizualizációban a felhasználói ügynök az elsődatetime
oszlopot használja. - Ha ez az oszlop típusú
dynamic
, és egy tömböt tartalmaz, a tömb egyes értékei az x tengely értékeiként lesznek kezelve.
- Például: a
- A táblázat egy vagy több oszlopa egy vagy több mértéket jelöl, amelyek az x tengelytől függően változnak.
Ezek az oszlopok explicit módon definiálhatók a
ycolumns
tulajdonság használatával. Ha nincs definiálva, a felhasználói ügynök kiválasztja a vizualizációnak megfelelő összes oszlopot.- Például: a vizualizációban a
timechart
felhasználói ügynök az összes olyan oszlopot használja, amelynek numerikus értéke nincs másként megadva. - Ha az x tengely tömb, akkor az egyes y tengelyek értékeinek is hasonló hosszúságú tömbnek kell lenniük, és mindegyik y tengely egyetlen oszlopban történik.
- Például: a vizualizációban a
- A tábla nulla vagy több oszlopa olyan egyedi dimenziókészletet jelöl, amely a mértékeket csoportosítja. Ezeket az oszlopokat megadhatja a
series
tulajdonság, vagy a felhasználói ügynök automatikusan kiválasztja őket az egyébként meghatározatlan oszlopokból.
Kapcsolódó tartalom
Megjegyzés
A renderelési operátor adatmodellje úgy tekinti meg a táblázatos adatokat, mintha háromféle oszlopból áll:
- Az x tengely oszlopa (amelyet a
xcolumn
tulajdonság jelez). - Az adatsoroszlopok (tetszőleges számú oszlop, amelyet a
series
tulajdonság jelöl.) - Az y tengely oszlopai (a tulajdonság által
ycolumns
jelzett tetszőleges számú oszlop). Az adatsor minden rekordhoz annyi mérést ("pontot" tartalmaz a diagramban), mint az y tengelyes oszlopok.
Példa
InsightsMetrics
| where Computer == "DC00.NA.contosohotels.com"
| where Namespace == "Processor" and Name == "UtilizationPercentage"
| summarize avg(Val) by Computer, bin(TimeGenerated, 1h)
| render timechart
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: