Bagikan melalui

operator render

  • Artikel

Berlaku untuk: ✅Microsoft Fabric✅✅

Menginstruksikan agen pengguna untuk merender visualisasi hasil kueri.

Operator render harus menjadi operator terakhir dalam kueri, dan hanya dapat digunakan dengan kueri yang menghasilkan satu hasil aliran data tabular. Operator render tidak mengubah data. Ini menginjeksi anotasi ("Visualisasi") ke dalam properti hasil yang diperluas. Anotasi berisi informasi yang diberikan oleh operator dalam kueri. Interpretasi informasi visualisasi dilakukan oleh agen pengguna. Agen yang berbeda, seperti Kusto.Explorer atau antarmuka pengguna web Azure Data Explorer, dapat mendukung visualisasi yang berbeda.

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

render [with(propertyName=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 diperlakukan sebagai set nilai skalar dan ditampilkan sebagai kartu.
columnchart Seperti barchart dengan strip vertikal bukan strip horizontal.
ladderchart Dua kolom terakhir adalah sumbu x, kolom lainnya adalah sumbu y.
linechart Grafik garis.
piechart Kolom pertama adalah sumbu warna, kolom kedua adalah numerik.
pivotchart Menampilkan tabel pivot dan bagan. Pengguna dapat secara interaktif memilih data, kolom, baris, dan berbagai jenis bagan.
scatterchart Grafik poin.
stackedareachart Grafik area bertumpuk.
table Default - hasil ditampilkan sebagai tabel.
timechart Grafik garis. Kolom pertama adalah sumbu x, dan harus datetime. Kolom (numerik) lainnya adalah sumbu y.
timepivot Navigasi interaktif pada garis waktu peristiwa (pivot pada 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 antarmuka pengguna 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 lainnya adalah numerik, ditampilkan sebagai strip horizontal.
columnchart Seperti barchart dengan strip vertikal bukan strip horizontal.
piechart Kolom pertama adalah sumbu warna, 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 diperlakukan sebagai set nilai skalar dan ditampilkan sebagai kartu.
columnchart Seperti barchart dengan strip vertikal bukan strip horizontal.
linechart Grafik garis.
piechart Kolom pertama adalah sumbu warna, 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 datetime. 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 akan 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

Visualisasi ini dapat dijabarkan lebih lanjut dengan menyediakan kind properti . Nilai yang didukung dari 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

Beberapa visualisasi digunakan untuk merender urutan nilai, misalnya, linechart, timechart, dan areachart. Visualisasi ini memiliki model konseptual berikut:

  • Satu kolom dalam tabel mewakili sumbu x data. Kolom ini dapat ditentukan secara eksplisit menggunakan properti xcolumn. Jika tidak ditentukan, agen pengguna memilih kolom pertama yang sesuai untuk visualisasi.
    • Misalnya: dalam timechart visualisasi, agen pengguna menggunakan kolom pertama datetime .
    • Jika kolom ini berjenis dynamic dan menyimpan array, nilai individual dalam array akan diperlakukan sebagai nilai sumbu x.
  • Satu atau beberapa kolom dalam tabel mewakili satu atau beberapa pengukuran yang bervariasi menurut sumbu x. Kolom-kolom ini dapat ditentukan secara eksplisit menggunakan ycolumns properti. Jika tidak ditentukan, agen pengguna memilih semua kolom yang sesuai untuk visualisasi.
    • Misalnya: dalam timechart visualisasi, agen pengguna menggunakan semua kolom dengan nilai numerik yang belum ditentukan 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. Kolom ini dapat ditentukan oleh series properti, atau agen pengguna akan memilihnya secara otomatis dari kolom yang tidak ditentukan.

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