render operátor

  • Cikk

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

  • summarizetop A és a használatával wherekorlá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|rendervizualizá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 anomalychartrelevá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.
  • 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.
  • 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