Aracılığıyla paylaş

render işleci

  • Makale

Kullanıcı aracısına sorgu sonuçlarının görselleştirmesini işlemesini sağlar.

İşleme işleci sorgudaki son işleç olmalıdır ve yalnızca tek bir tablosal veri akışı sonucu oluşturan sorgularla kullanılabilir. İşleme işleci verileri değiştirmez. Sonucun genişletilmiş özelliklerine bir ek açıklama ("Görselleştirme") ekler. Ek açıklama, sorgudaki işleç tarafından sağlanan bilgileri içerir. Görselleştirme bilgilerinin yorumlanması kullanıcı aracısı tarafından gerçekleştirilir. Kusto.Explorer veya Azure Veri Gezgini web kullanıcı arabirimi gibi farklı aracılar farklı görselleştirmeleri destekleyemeyebilir.

İşleme işlecinin veri modeli, tablosal verilere üç tür sütuna sahipmiş gibi bakar:

  • x ekseni sütunu (özelliğiyle xcolumn gösterilir).
  • Seri sütunları (özelliği tarafından series belirtilen herhangi bir sayıda sütun.) Her kayıt için, bu sütunların birleştirilmiş değerleri tek bir seri tanımlar ve grafikte ayrı birleştirilmiş değerler olduğu kadar çok seri vardır.
  • y ekseni sütunları (özelliği tarafından ycolumns belirtilen herhangi bir sayıda sütun). Her kayıt için, serinin y ekseni sütunları kadar ölçümü vardır ("grafikte noktalar").

İpucu

  • Görüntüdüğünüz birimi sınırlamak için ve summarize top kullanınwhere.
  • X ekseninin sırasını tanımlamak için verileri sıralayın.
  • Kullanıcı aracıları, sorgu tarafından belirtilmeyen özelliklerin değerini "tahmin etmek" için serbesttir. Özellikle, sonucun şemasında "ilgi çekici olmayan" sütunların olması, yanlış tahmin etmelerine neden olabilir. Böyle bir durumda bu tür sütunları yansıtmayı deneyin.

Not

Yalnızca Azure Veri Gezgini panolarında kullanılabilen bazı görselleştirmeler vardır. Daha fazla bilgi için bkz . Panoya özgü görseller.

Sözdizimi

T | render görselleştirmesi [with ( propertyName = propertyValue [, ...]])

Söz dizimi kuralları hakkında daha fazla bilgi edinin.

Parametreler

Ad Tür Zorunlu Açıklama
T string ✔️ Giriş tablosu adı.
Görsel -leştirme string ✔️ Kullanılacak görselleştirme türünü gösterir. Aşağıdaki listede desteklenen değerlerden biri olmalıdır.
propertyName, propertyValue string Anahtar-değer özellik çiftlerinin virgülle ayrılmış listesi. Desteklenen özelliklere bakın.

Görselleştirme

Görsel -leştirme Açıklama Çizim
anomalychart Zaman çizelgesine benzer, ancak series_decompose_anomalies işlevini kullanarak anomalileri vurgular.
areachart Alan grafiği.
barchart yatay şeritler olarak görüntülenir.
card İlk sonuç kaydı skaler değerler kümesi olarak değerlendirilir ve kart olarak gösterilir.
columnchart Yatay şeritler yerine dikey şeritlerle olduğu gibi barchart .
ladderchart Son iki sütun x ekseni, diğer sütunlar y eksenidir.
linechart Çizgi grafik.
piechart İlk sütun renk ekseni, ikinci sütun ise sayısaldır.
pivotchart Bir özet tablo ve grafik görüntüler. Kullanıcı etkileşimli olarak verileri, sütunları, satırları ve çeşitli grafik türlerini seçebilir.
scatterchart Puan grafiği.
stackedareachart Yığılmış alan grafiği.
table Varsayılan : sonuçlar tablo olarak gösterilir.
timechart Çizgi grafik. İlk sütun x eksenidir ve tarih saat olmalıdır. Diğer (sayısal) sütunlar y eksenleridir.
timepivot Olaylar zaman çizgisi üzerinde etkileşimli gezinti (zaman ekseninde özetleme)
treemap Hiyerarşik verileri iç içe yerleştirilmiş dikdörtgenler kümesi olarak görüntüler.

Not

Merdiven çizelgesi, pivotchart, timepivot ve ağaç haritası görselleştirmeleri Kusto.Explorer'da kullanılabilir ancak Azure Veri Gezgini web kullanıcı arabiriminde kullanılamaz.

Görsel -leştirme Açıklama Çizim
areachart Alan grafiği. İlk sütun x eksenidir ve sayısal bir sütun olmalıdır. Diğer sayısal sütunlar y eksenleridir.
barchart İlk sütun x eksenidir ve metin, tarih saat veya sayısal olabilir. Diğer sütunlar sayısaldır ve yatay şeritler olarak görüntülenir.
columnchart Yatay şeritler yerine dikey şeritlerle olduğu gibi barchart .
piechart İlk sütun renk ekseni, ikinci sütun ise sayısaldır.
scatterchart Puan grafiği. İlk sütun x eksenidir ve sayısal bir sütun olmalıdır. Diğer sayısal sütunlar y eksenleridir.
table Varsayılan : sonuçlar tablo olarak gösterilir.
timechart Çizgi grafik. İlk sütun x eksenidir ve tarih saat olmalıdır. Diğer (sayısal) sütunlar y eksenleridir. Değerleri sayısal sütunları "gruplandırmak" ve grafikte farklı çizgiler oluşturmak için kullanılan bir dize sütunu vardır (diğer dize sütunları yoksayılır).
Görsel -leştirme Açıklama Çizim
anomalychart Zaman çizelgesine benzer, ancak series_decompose_anomalies işlevini kullanarak anomalileri vurgular.
areachart Alan grafiği.
barchart yatay şeritler olarak görüntülenir.
card İlk sonuç kaydı skaler değerler kümesi olarak değerlendirilir ve kart olarak gösterilir.
columnchart Yatay şeritler yerine dikey şeritlerle olduğu gibi barchart .
linechart Çizgi grafik.
piechart İlk sütun renk ekseni, ikinci sütun ise sayısaldır.
scatterchart Puan grafiği.
stackedareachart Yığılmış alan grafiği.
table Varsayılan : sonuçlar tablo olarak gösterilir.
timechart Çizgi grafik. İlk sütun x eksenidir ve tarih saat olmalıdır. Diğer (sayısal) sütunlar y eksenleridir.

Desteklenen özellikler

PropertyName/PropertyValue , işleme sırasında kullanılacak ek bilgileri gösterir. Tüm özellikler isteğe bağlıdır. Desteklenen özellikler şunlardır:

PropertyName PropertyValue
accumulate Her ölçünün değerinin tüm öncüllerine eklenip eklenmeyeceği. (true veya false)
kind Görselleştirme türünün daha ayrıntılı bir şekilde incelenmesi. Daha fazla bilgi için bkz kind . özellik.
legend Gösterge görüntülenip görüntülenmeyeceği (visible veya hidden).
series Kayıt başına birleşik değerleri kaydın ait olduğu seriyi tanımlayan sütunların virgülle ayrılmış listesi.
ymin Y ekseninde görüntülenecek en düşük değer.
ymax Y ekseninde görüntülenecek en büyük değer.
title Görselleştirmenin başlığı (türünde string).
xaxis X eksenini (linear veya log) ölçeklendirme
xcolumn Sonuçtaki hangi sütun x ekseni için kullanılır.
xtitle x ekseninin başlığı (türü string).
yaxis Y eksenini (linear veya log) ölçeklendirme
ycolumns x sütununun değeri başına sağlanan değerlerden oluşan sütunların virgülle ayrılmış listesi.
ysplit Görselleştirmeyi birden çok kez bölme. Daha fazla bilgi için bkz y-split . özellik.
ytitle y ekseninin başlığı (türü string).
anomalycolumns Yalnızca ile anomalychartilgili özellik. Anomali serisi olarak değerlendirilecek ve grafikte nokta olarak görüntülenecek, virgülle ayrılmış sütun listesi
PropertyName PropertyValue
kind Görselleştirme türünün daha ayrıntılı bir şekilde incelenmesi. Daha fazla bilgi için bkz kind . özellik.
series Kayıt başına birleşik değerleri kaydın ait olduğu seriyi tanımlayan sütunların virgülle ayrılmış listesi.
title Görselleştirmenin başlığı (türünde string).

kind mülk

Bu görselleştirme özelliği sağlanarak daha ayrıntılı bir şekilde kind anlatılabilir. Bu özelliğin desteklenen değerleri şunlardır:

Görsel -leştirme kind Açıklama
areachart default Her "alan" kendi kendine durur.
unstacked ile defaultaynı.
stacked "Alanlar" öğesini sağa yığın.
stacked100 "Alanları" sağa yığın ve her birini diğerleriyle aynı genişliğe kadar uzatın.
barchart default Her "bar" kendi kendine durur.
unstacked ile defaultaynı.
stacked Yığın "çubukları".
stacked100 "Çubukları" yığın ve her birini diğerleriyle aynı genişliğe kadar uzatın.
columnchart default Her "sütun" kendi başına durur.
unstacked ile defaultaynı.
stacked "Sütunları" bir üst üste yığın.
stacked100 "Sütunları" yığın ve her birini diğerleriyle aynı yüksekliğe kadar uzatın.
scatterchart map Beklenen sütunlar [Boylam, Enlem] veya GeoJSON noktasıdır. Seri sütunu isteğe bağlıdır. Daha fazla bilgi için bkz . Jeo-uzamsal görselleştirmeler.
piechart map Beklenen sütunlar [Boylam, Enlem] veya GeoJSON noktası, renk ekseni ve sayısaldır. Kusto Explorer masaüstünde desteklenir. Daha fazla bilgi için bkz . Jeo-uzamsal görselleştirmeler.

ysplit mülk

Bazı görselleştirmeler birden çok y ekseni değerine bölünmeyi destekler:

ysplit Açıklama
none Tüm seri verileri için tek bir y ekseni görüntülenir. EnterprisePublishing
axes Tek bir grafik birden çok y ekseniyle (seri başına bir tane) görüntülenir.
panels Her ycolumn değer için bir grafik işlenir (bir sınıra kadar).

Sürekli verileri işleme

Değer dizilerini işlemek için çeşitli görselleştirmeler kullanılır, örneğin, linechart, timechartve areachart. Bu görselleştirmeler aşağıdaki kavramsal modele sahiptir:

  • Tablodaki bir sütun, verilerin x eksenini temsil eder. Bu sütun, özelliği kullanılarak xcolumn açıkça tanımlanabilir. Tanımlanmamışsa, kullanıcı aracısı görselleştirme için uygun olan ilk sütunu seçer.
    • Örneğin: görselleştirmede timechart kullanıcı aracısı ilk datetime sütunu kullanır.
    • Bu sütun türündeyse dynamic ve bir dizi barındırıyorsa, dizideki tek tek değerler x ekseninin değerleri olarak kabul edilir.
  • Tablodaki bir veya daha fazla sütun, x eksenine göre değişen bir veya daha fazla ölçüleri temsil eden bir veya daha fazla ölçüye sahip. Bu sütunlar özelliği kullanılarak ycolumns açıkça tanımlanabilir. Tanımlanmamışsa, kullanıcı aracısı görselleştirme için uygun olan tüm sütunları seçer.
    • Örneğin: görselleştirmede timechart kullanıcı aracısı, aksi belirtilmediği sayısal değere sahip tüm sütunları kullanır.
    • X ekseni bir diziyse, her y ekseninin değerleri de benzer uzunlukta bir dizi olmalıdır ve her y ekseni tek bir sütunda gerçekleşir.
  • Tablodaki sıfır veya daha fazla sütun, ölçüleri birlikte gruplandıran benzersiz bir boyut kümesini temsil eder. Bu sütunlar özelliği tarafından series belirtilebilir veya kullanıcı aracısı aksi takdirde belirtilmeyen sütunlardan bunları otomatik olarak seçer.

İlgili içerik

Not

İşleme işlecinin veri modeli, tablosal verilere üç tür sütuna sahipmiş gibi bakar:

  • x ekseni sütunu (özelliğiyle xcolumn gösterilir).
  • Seri sütunları (özelliği tarafından series belirtilen herhangi bir sayıda sütun.)
  • y ekseni sütunları (özelliği tarafından ycolumns belirtilen herhangi bir sayıda sütun). Her kayıt için, serinin y ekseni sütunları kadar ölçümü vardır ("grafikte noktalar").

Örnek

InsightsMetrics
| where Computer == "DC00.NA.contosohotels.com"
| where Namespace  == "Processor" and Name == "UtilizationPercentage"
| summarize avg(Val) by Computer, bin(TimeGenerated, 1h)
| render timechart