operator render

Beralih layanan menggunakan menu tarik-turun Versi. Pelajari selengkapnya tentang navigasi.
Berlaku untuk: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

Operator render menginstruksikan agen pengguna untuk memvisualisasikan hasil kueri. Ini harus menjadi operator terakhir dalam kueri Anda dan hanya berfungsi dengan kueri yang menghasilkan satu aliran data tabular.

Operator tidak mengubah data. Sebaliknya, ini menambahkan anotasi "Visualisasi" ke properti hasil yang diperluas, yang berisi instruksi visualisasi dari kueri Anda. Agen pengguna yang berbeda, seperti Kusto.Explorer atau Azure Data Explorer web UI, menafsirkan dan mendukung visualisasi yang berbeda berdasarkan informasi ini.

Model data operator render melihat data tabular seolah-olah memiliki tiga jenis kolom:

  • Kolom sumbu x (ditunjukkan oleh xcolumn properti).
  • Kolom seri (sejumlah kolom yang ditunjukkan oleh series properti.) Untuk setiap rekaman, nilai gabungan kolom ini menentukan satu seri, dan bagan memiliki seri sebanyak ada nilai gabungan yang berbeda.
  • Kolom sumbu y (sejumlah kolom yang ditunjukkan oleh ycolumns properti). Untuk setiap rekaman, seri ini memiliki banyak pengukuran ("titik" dalam bagan) karena ada kolom sumbu y.

Tip

  • Gunakan where, summarize dan top untuk membatasi volume yang Anda tampilkan.
  • Urutkan data untuk menentukan urutan sumbu x.
  • Agen pengguna bebas untuk "menebak" nilai properti yang tidak ditentukan oleh kueri. Secara khusus, memiliki kolom "tidak menarik" dalam skema hasil mungkin diterjemahkan ke dalamnya salah menebak. Coba proyeksikan kolom seperti itu ketika itu terjadi.

Catatan

Ada beberapa visualisasi yang hanya tersedia di dasbor Azure Data Explorer. Untuk informasi selengkapnya, lihat Visual khusus dasbor.

Sintaks

| [renderwith(propertyValue [= ...]]

Pelajari selengkapnya tentang konvensi sintaksis.

Parameter

Nama Tipe Wajib Deskripsi
T string ✔️ Nama tabel input.
Visualisasi string ✔️ Menunjukkan jenis visualisasi yang akan digunakan. Harus menjadi salah satu nilai yang didukung dalam daftar berikut.
propertyName, propertyValue string Daftar pasangan properti kunci-nilai yang dipisahkan koma. Lihat properti yang didukung.

Visualisasi

Visualisasi Deskripsi Ilustrasi
anomalychart Mirip dengan bagan waktu, tetapi menyoroti anomali menggunakan fungsi series_decompose_anomalies .
areachart Grafik area.
barchart Ditampilkan sebagai strip horizontal.
card Rekaman hasil pertama adalah sekumpulan nilai skalar dan ditampilkan sebagai kartu.
columnchart Seperti barchart dengan strip vertikal bukan strip horizontal.
ladderchart Dua kolom terakhir adalah sumbu x, dan kolom lainnya adalah sumbu y.
linechart Grafik garis.
piechart Kolom pertama adalah sumbu warna, dan kolom kedua adalah numerik.
pivotchart Menampilkan tabel pivot dan bagan. Anda dapat memilih data, kolom, baris, dan berbagai jenis bagan secara interaktif.
scatterchart Grafik poin.
stackedareachart Grafik area bertumpuk.
table Default - hasil ditampilkan sebagai tabel.
timechart Grafik garis. Kolom pertama adalah sumbu x, dan harus tanggalwaktu. Kolom (numerik) lainnya adalah sumbu y.
timepivot Navigasi interaktif melalui garis waktu peristiwa (mempivot sumbu waktu).
treemap Menampilkan data hierarkis sebagai sekumpulan persegi panjang berlapis.

Catatan

Visualisasi ladderchart, pivotchart, timepivot, dan treemap dapat digunakan di Kusto.Explorer tetapi tidak tersedia di UI web Azure Data Explorer.

Visualisasi Deskripsi Ilustrasi
areachart Grafik area. Kolom pertama adalah sumbu x dan harus berupa kolom numerik. Kolom numerik lainnya adalah sumbu y.
barchart Kolom pertama adalah sumbu x dan dapat berupa teks, tanggalwaktu, atau numerik. Kolom lain bersifat numerik dan ditampilkan sebagai strip horizontal.
columnchart Seperti barchart dengan strip vertikal bukan strip horizontal.
piechart Kolom pertama adalah sumbu warna, dan kolom kedua adalah numerik.
scatterchart Grafik poin. Kolom pertama adalah sumbu x dan harus berupa kolom numerik. Kolom numerik lainnya adalah sumbu y.
table Default - hasil ditampilkan sebagai tabel.
timechart Grafik garis. Kolom pertama adalah sumbu x, dan harus tanggalwaktu. Kolom (numerik) lainnya adalah sumbu y. Ada satu kolom karakter yang nilainya digunakan untuk "grup" kolom numerik dan membuat garis yang berbeda dalam bagan (kolom karakter lebih lanjut diabaikan).
Visualisasi Deskripsi Ilustrasi
anomalychart Mirip dengan bagan waktu, tetapi menyoroti anomali menggunakan fungsi series_decompose_anomalies .
areachart Grafik area.
barchart Ditampilkan sebagai strip horizontal.
card Rekaman hasil pertama adalah sekumpulan nilai skalar dan ditampilkan sebagai kartu.
columnchart Seperti barchart dengan strip vertikal bukan strip horizontal.
linechart Grafik garis.
piechart Kolom pertama adalah sumbu warna, dan kolom kedua adalah numerik.
scatterchart Grafik poin.
stackedareachart Grafik area bertumpuk.
table Default - hasil ditampilkan sebagai tabel.
timechart Grafik garis. Kolom pertama adalah sumbu x, dan harus tanggalwaktu. Kolom (numerik) lainnya adalah sumbu y.

Properti yang didukung

PropertyName/PropertyValue menunjukkan informasi tambahan untuk digunakan saat merender. Semua properti bersifat opsional. Properti yang didukung adalah:

PropertyName PropertyValue
accumulate Apakah nilai dari setiap ukuran akan ditambahkan ke semua pendahulunya. (true atau false)
kind Elaborasi lebih lanjut dari jenis visualisasi. Untuk informasi selengkapnya, lihat kind properti.
legend Apakah akan menampilkan legenda atau tidak (visible atau hidden).
series Daftar kolom yang dibatasi koma yang nilai per-rekaman gabungannya menentukan seri yang dimiliki rekaman tersebut.
ymin Nilai minimum yang akan ditampilkan pada sumbu Y.
ymax Nilai maksimum yang akan ditampilkan pada sumbu Y.
title Judul visualisasi (tipe string).
xaxis Cara menskalakan sumbu x (linear atau log).
xcolumn Kolom mana dalam hasil yang digunakan untuk sumbu x.
xtitle Judul sumbu x (tipe string).
yaxis Cara menskalakan sumbu y (linear atau log).
ycolumns Daftar kolom yang dibatasi koma yang terdiri dari nilai yang diberikan per nilai kolom x.
ysplit Cara membagi visualisasi menjadi beberapa nilai sumbu y. Untuk informasi selengkapnya, lihat y-split properti.
ytitle Judul sumbu y (tipe string).
anomalycolumns Properti yang relevan hanya untuk anomalychart. Daftar kolom yang dibatasi koma, yang dianggap sebagai seri anomali dan ditampilkan sebagai titik pada bagan
PropertyName PropertyValue
kind Elaborasi lebih lanjut dari jenis visualisasi. Untuk informasi selengkapnya, lihat kind properti.
series Daftar kolom yang dibatasi koma yang nilai per-rekaman gabungannya menentukan seri yang dimiliki rekaman tersebut.
title Judul visualisasi (tipe string).

Properti kind

Anda dapat menguraikan visualisasi ini lebih lanjut dengan menyediakan kind properti . Nilai yang didukung untuk properti ini adalah:

Visualisasi kind Deskripsi
areachart default Setiap "area" berdiri sendiri.
unstacked Sama seperti default.
stacked Tumpuk "area" di sebelah kanan.
stacked100 Tumpuk "area" ke kanan dan rentangkan masing-masing ke lebar yang sama dengan yang lain.
barchart default Setiap "bar" berdiri sendiri.
unstacked Sama seperti default.
stacked Tumpuk "bar".
stacked100 Tumpuk "bar" dan rentangkan masing-masing ke lebar yang sama dengan yang lain.
columnchart default Setiap "kolom" berdiri sendiri.
unstacked Sama seperti default.
stacked Tumpuk "kolom" satu di atas yang lain.
stacked100 Tumpuk "kolom" dan rentangkan masing-masing ke ketinggian yang sama dengan yang lain.
scatterchart map Kolom yang diharapkan adalah [Garis bujur, Garis lintang] atau titik GeoJSON. Kolom seri bersifat opsional. Untuk informasi selengkapnya, lihat Visualisasi geospasial.
piechart map Kolom yang diharapkan adalah [Garis bujur, Garis lintang] atau titik GeoJSON, sumbu warna dan numerik. Didukung di desktop Kusto Explorer. Untuk informasi selengkapnya, lihat Visualisasi geospasial.

Properti ysplit

Beberapa visualisasi mendukung pemisahan menjadi beberapa nilai sumbu y:

ysplit Deskripsi
none Sumbu y tunggal ditampilkan untuk semua data seri. (Default)
axes Bagan tunggal ditampilkan dengan beberapa sumbu y (satu per seri).
panels Satu bagan dirender untuk setiap nilai ycolumn. Maksimum lima panel.

Cara merender data berkelanjutan

Untuk merender urutan nilai, gunakan beberapa visualisasi, seperti linechart, , timechartdan areachart. Visualisasi ini mengikuti model konseptual:

  • Satu kolom dalam tabel mewakili sumbu x data. Anda dapat secara eksplisit menentukan kolom ini dengan menggunakan xcolumn properti . Jika Anda tidak menentukannya, agen pengguna memilih kolom pertama yang berfungsi untuk visualisasi.
    • Misalnya, dalam timechart visualisasi, agen pengguna menggunakan kolom pertama datetime .
    • Jika kolom ini berjenis dynamic dan menyimpan array, nilai individual dalam array diperlakukan sebagai nilai sumbu x.
  • Satu atau beberapa kolom dalam tabel mewakili satu atau beberapa pengukuran yang bervariasi menurut sumbu x. Anda dapat secara eksplisit menentukan kolom ini dengan menggunakan ycolumns properti . Jika Anda tidak menentukannya, agen pengguna memilih semua kolom yang berfungsi untuk visualisasi.
    • Misalnya, dalam timechart visualisasi, agen pengguna menggunakan semua kolom dengan nilai numerik yang tidak Anda tentukan sebaliknya.
    • Jika sumbu x adalah array, nilai setiap sumbu y juga harus berupa array dengan panjang yang sama, dengan setiap sumbu y terjadi dalam satu kolom.
  • Nol atau lebih kolom dalam tabel mewakili sekumpulan dimensi unik yang mengelompokkan pengukuran bersama-sama. Anda dapat menentukan kolom ini dengan menggunakan series properti , atau agen pengguna memilihnya secara otomatis dari kolom yang tidak ditentukan.

Konten terkait

Catatan

Model data operator render melihat data tabular seolah-olah memiliki tiga jenis kolom:

  • Kolom sumbu x (ditunjukkan oleh xcolumn properti).
  • Kolom seri (sejumlah kolom yang ditunjukkan oleh series properti ).
  • Kolom sumbu y (sejumlah kolom yang ditunjukkan oleh ycolumns properti). Untuk setiap rekaman, seri ini memiliki banyak pengukuran ("titik" dalam bagan) karena ada kolom sumbu y.

Contoh

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