Menggunakan parameter di dasbor Azure Data Explorer

Parameter digunakan sebagai blok penyusun untuk filter di dasbor Azure Data Explorer. Mereka dikelola dalam lingkup dasbor, dan dapat ditambahkan ke kueri untuk memfilter data yang ditampilkan oleh visual terkait. Kueri dapat menggunakan satu atau beberapa parameter.

Artikel ini menjelaskan pembuatan dan penggunaan parameter dan filter tertaut di dasbor. Gunakan parameter untuk memfilter visual dasbor baik dengan memilih nilai parameter di bilah filter atau dengan menggunakan filter silang.

Catatan

Manajemen parameter tersedia dalam mode Pengeditan bagi editor dasbor.

Prasyarat

• Memvisualisasikan data dengan dasbor Azure Data Explorer
• Izin editor pada dasbor Azure Data Explorer
• Dasbor dengan visualisasi

Buat parameter

Untuk membuat parameter:

1. Beralih dari mode Menampilkan ke Pengeditan .

   

2. Pilih tombol Parameter di toolbar atas.

   

3. Pilih tombol + Tambahkan di panel sisi Tambahkan parameter .

   

4. Isi properti yang relevan untuk parameter Anda.

   

Lihat daftar parameter

Untuk melihat daftar semua parameter dasbor, pilih tombol Parameter di toolbar atas.

Properti yang didukung

Di panel sisi Tambahkan parameter , konfigurasikan properti berikut ini:

Bidang	Deskripsi
Label	Nama parameter yang ditampilkan di dasbor atau kartu edit.
Tipe parameter	Salah satu parameter berikut: Pilihan tunggal: Hanya satu nilai yang dapat dipilih dalam filter sebagai input untuk parameter . Beberapa pilihan: Satu atau beberapa nilai dapat dipilih dalam filter sebagai input untuk parameter . Rentang waktu: Memungkinkan pembuatan lebih banyak parameter untuk memfilter kueri dan dasbor berdasarkan waktu. Setiap dasbor memiliki pemilih rentang waktu secara default. Teks gratis: Tidak memiliki nilai apa pun yang diisi dalam filter. Pengguna dapat mengetik nilai atau menyalin/menempelkan nilai ke bidang teks. Filter menyimpan nilai terbaru yang digunakan.
Nama variabel	Nama parameter yang akan digunakan dalam kueri. Tips: Memberi awalan nama variabel dengan karakter yang khas, seperti karakter garis bawah (_), membuatnya lebih mudah ditemukan saat menulis kueri.
Jenis data	Jenis data nilai parameter.
Perlihatkan pada halaman	Pilih halaman tempat parameter ini ditampilkan. Opsi Pilih semua memperlihatkan parameter di semua halaman.
Sumber	Sumber nilai parameter: Nilai tetap: Memperkenalkan nilai filter statis secara manual. Kueri: Memperkenalkan nilai secara dinamis menggunakan kueri KQL.
Nilai bawaan	Nilai bawaan filter. Filter selalu dimulai dengan nilai default setelah penyajian awal dasbor.
Menambahkan nilai "Pilih semua"	Hanya berlaku untuk pilihan tunggal dan beberapa jenis parameter pilihan. Digunakan untuk mengambil data untuk semua nilai parameter. Nilai ini harus dibangun ke dalam kueri untuk menyediakan fungsionalitas. Untuk contoh selengkapnya tentang membangun kueri tersebut, lihat Menggunakan parameter berbasis kueri beberapa pilihan.

Kelola parameter

Setelah memilih Parameter dari toolbar atas, Anda dapat melihat daftar parameter yang ada. Di setiap kartu parameter, pilih widget pensil untuk mengedit parameter, tempat sampah yang akan dihapus, atau pilih menu Lainnya [...] untuk Menduplikasi atau memindahkan parameter. Sebagai alternatif, kartu dapat diurutkan ulang dengan menyeret dan melepasnya.

Indikator berikut dapat dilihat dalam kartu parameter:

• Nama tampilan parameter
• Nama variabel
• Jumlah kueri tempat parameter digunakan
• Halaman tempat parameter disematkan

Gunakan parameter dalam kueri Anda

Untuk membuat filter berfungsi untuk visual kueri, Anda harus menggunakan parameter dalam kueri. Saat Anda menentukan parameter, Anda melihatnya di bilah atas filter halaman Kueri dan di Kueri IntelliSense.

Catatan

Jika Anda tidak menggunakan parameter dalam kueri, filter tetap tidak aktif. Saat Anda menambahkan parameter ke kueri, filter menjadi aktif.

Jenis parameter

Beberapa jenis parameter dasbor didukung, sebagai berikut:

• Parameter rentang waktu default
• Parameter nilai tetap pilihan tunggal
• Parameter nilai tetap multi-pilihan
• Parameter berbasis kueri pilihan tunggal
• Parameter berbasis kueri untuk pemilihan ganda
• Parameter teks bebas
• Parameter sumber data

Contoh berikut menjelaskan cara menggunakan parameter dalam kueri untuk berbagai jenis parameter.

Parameter rentang waktu default

Setiap dasbor memiliki parameter Rentang waktu secara default. Hal ini muncul di dasbor sebagai filter hanya jika digunakan dalam kueri. Gunakan kata kunci _startTime parameter dan _endTime untuk menggunakan parameter rentang waktu default dalam kueri seperti yang terlihat dalam contoh berikut:

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Setelah Anda menyimpan, filter rentang waktu muncul di dasbor. Sekarang Anda dapat menggunakannya untuk memfilter data pada kartu. Anda dapat memfilter dasbor dengan memilih dari menu dropdown: Rentang waktu (x menit terakhir, jam, atau hari) atau Rentang waktu kustom.

Parameter pilihan tunggal dengan nilai tetap

Parameter nilai tetap didasarkan pada nilai yang telah ditentukan sebelumnya yang ditentukan oleh pengguna. Contoh berikut menunjukkan kepada Anda cara membuat parameter nilai tetap satu pilihan.

Membuat parameter nilai tetap pilihan tunggal

1. Pilih Parameter untuk membuka panel Parameter dan pilih Parameter baru.

2. Isi detailnya sebagai berikut:

   • Label: Jenis Peristiwa

   • Jenis parameter: Pilihan tunggal

   • Nama variabel: _eventType

   • Jenis data: String

   • Sematkan sebagai filter dasbor: dicentang

   • Sumber: Nilai tetap

     Dalam contoh ini, gunakan nilai berikut:

     Nilai	Nama tampilan parameter
     Angin Badai Petir	Angin badai petir
     Hujan es	Hujan es
     Banjir Bandang	Banjir bandang
     Kekeringan	Kekeringan
     Cuaca Musim Dingin	Cuaca musim dingin

   • Tambahkan nilai “Pilih semua”: Tidak dicentang

   • Nilai default: Thunderstorm Wind

3. Pilih Selesai untuk membuat parameter.

Parameter tersebut dapat dilihat di panel samping Parameter, tetapi saat ini tidak digunakan di visual mana pun.

Menggunakan parameter nilai tetap pilihan tunggal

1. Jalankan kueri sampel yang menggunakan parameter Jenis Peristiwa baru dengan menggunakan _eventType nama variabel:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType == _eventType
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Parameter baru muncul di daftar parameter di bagian atas dasbor.

2. Pilih nilai yang berbeda untuk memperbarui visual.

   

Parameter nilai tetap dengan beberapa pilihan

Parameter nilai tetap didasarkan pada nilai yang telah ditentukan sebelumnya yang ditentukan oleh pengguna. Contoh berikut menunjukkan kepada Anda cara membuat dan menggunakan parameter nilai tetap beberapa pilihan.

Buat parameter nilai tetap multi-pilihan

1. Pilih Parameter untuk membuka panel Parameter dan pilih Parameter baru.

2. Isi detailnya sebagaimana disebutkan dalam Menggunakan parameter nilai tetap dengan pilihan tunggal dengan perubahan berikut:

   • Label: Jenis Peristiwa
   • Jenis parameter: Beberapa pilihan
   • Nama variabel: _eventType

3. Pilih Selesai untuk membuat parameter.

Parameter baru tersebut dapat dilihat di panel sisi Parameter, tetapi saat ini belum digunakan dalam visual apa pun.

Gunakan parameter nilai tetap dengan pilihan ganda

1. Jalankan kueri sampel menggunakan parameter baru Jenis Peristiwa dengan menggunakan variabel _eventType.

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Parameter baru muncul di daftar parameter di bagian atas dasbor.

2. Pilih satu atau beberapa nilai berbeda untuk memperbarui visual.

   

Parameter berbasis query untuk pilihan tunggal

Nilai parameter berbasis kueri diambil selama pemuatan dasbor dengan menjalankan kueri parameter. Contoh berikut menunjukkan kepada Anda cara membuat dan menggunakan parameter berbasis kueri pilihan tunggal.

Buat parameter berbasis kueri dengan satu pilihan

1. Pilih Parameter untuk membuka panel Parameter dan pilih Parameter baru.

2. Isi detailnya sebagaimana disebutkan dalam Menggunakan parameter nilai tetap dengan pilihan tunggal dengan perubahan berikut:

   • Label: Status

   • Nama variabel: _state

   • Sumber: Kueri

   • Sumber data: StormEventsSample

   • Pilih Edit kueri dan masukkan kueri berikut. Pilih Selesai.

     StormEvents
     | where StartTime between (_startTime.._endTime)
     | where EventType in (_eventType) or isempty(_eventType)
     | summarize TotalEvents = count() by State
     | top 5 by TotalEvents
     | project State
     

   • Nilai: Status

   • Nama tampilan: Status

   • Nilai default: Pilih nilai default

3. Pilih Selesai untuk membuat parameter.

Gunakan parameter berbasis kueri pilihan tunggal

1. Contoh kueri berikut dengan parameter Status baru menggunakan _state variabel :

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State == _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Parameter baru muncul di daftar parameter di bagian atas dasbor.

2. Pilih nilai yang berbeda untuk memperbarui visual.

Parameter berbasis kueri beberapa pilihan

Nilai parameter berbasis kueri berasal dari menjalankan kueri yang ditentukan pengguna saat dasbor dimuat. Contoh berikut menunjukkan cara membuat parameter berbasis kueri beberapa pilihan:

Membuat parameter berbasis kueri beberapa pilihan

1. Pilih Parameter untuk membuka panel Parameter dan pilih + Parameter baru.

2. Isi detail seperti yang dijelaskan dalam Menggunakan parameter nilai tetap pilihan tunggal dengan perubahan berikut:

   • Label: Status
   • Jenis parameter: Beberapa pilihan
   • Nama variabel: _state

3. Pilih Selesai untuk membuat parameter.

Gunakan parameter berbasis kueri multi-pilihan

1. Kueri sampel berikut menggunakan parameter Status baru dengan menggunakan _state variabel .

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State in (_state) or isempty(_state)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Catatan

   Sampel ini menggunakan opsi Pilih Semua dengan memeriksa nilai kosong dengan isempty() fungsi .

   Parameter baru muncul di daftar parameter di bagian atas dasbor.

2. Pilih satu atau beberapa nilai berbeda untuk memperbarui visual.

Parameter teks bebas

Parameter teks gratis tidak berisi nilai apa pun. Mereka memungkinkan Anda untuk memperkenalkan nilai Anda sendiri.

Buat parameter teks bebas

1. Pilih Parameter untuk membuka panel Parameter dan pilih + Parameter baru.

2. Isi detailnya sebagai berikut:

   • Label: Status
   • Jenis parameter: Teks gratis
   • Nama variabel: _state
   • Jenis data: String
   • Nilai bawaan: Tidak ada nilai bawaan

Menggunakan parameter teks gratis

1. Jalankan kueri sampel menggunakan parameter Status baru dengan menggunakan _state nama variabel:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State contains _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

Parameter sumber data

Setelah menambahkan sumber data ke dasbor, Anda dapat membuat parameter yang memilih satu atau beberapa sumber data yang tersedia. Parameter ini dapat digunakan dalam tile dan parameter lainnya.

Membuat parameter sumber data

1. Pilih Parameter untuk membuka panel Parameter dan pilih + Parameter baru.

2. Isi detailnya sebagai berikut:

   • Label: Sumber
   • Jenis parameter: Sumber data
   • Perlihatkan pada halaman: Pilih semua
   • Nilai: Pilih semua
   • Nilai default: StormEventsSample

3. Pilih Selesai.

Parameter baru sekarang terlihat dalam daftar parameter di bagian atas dasbor.

Menggunakan parameter sumber data

1. Navigasikan ke kueri petak peta baru atau yang sudah ada.

2. Di Sumber, pilih nama parameter baru Anda di bawah Parameter sumber data. Untuk parameter yang dibuat di atas, pilih Kluster.

3. Pilih Terapkan perubahan.

4. Gunakan parameter Kluster untuk mengubah sumber data untuk kueri yang tersambung ini.

Parameter filter silang

Filter silang memungkinkan Anda memilih nilai dalam satu visual dan semua visual dasbor, seperti bagan garis atau sebar, difilter untuk hanya menampilkan data terkait. Menggunakan filter silang mencapai hasil yang sama dengan memilih nilai yang setara untuk parameter dalam daftar parameter di bagian atas dasbor.

Tentukan filter silang

Untuk membuat filter silang, Anda harus mengaktifkan opsi di visual, lalu menentukan parameter yang digunakan untuk memfilter data.

1. Navigasikan ke kueri petak di mana Anda ingin menambahkan filter silang.

2. Pilih Visual.

3. Di panel kanan, pilih Interaksi, lalu aktifkan filter silang.

4. Secara opsional, tentukan jenis Interaksi . Defaultnya adalah Titik tempat Anda dapat memilih nilai dalam visual. Untuk memilih rentang nilai, seperti dalam bagan waktu, pilih Seret.

5. Tentukan kolom yang digunakan untuk memberikan nilai dan parameter yang digunakan untuk memfilter kueri.

   Penting

   Kolom dan parameter harus memiliki jenis data yang sama.

Berinteraksi dengan data Anda dengan filter silang

Setelah filter silang ditentukan, Anda dapat menggunakannya untuk berinteraksi dengan data Anda. Di visual tempat Anda menentukan filter silang, Anda dapat memilih titik data dan menggunakan nilainya untuk memfilter halaman dasbor saat ini. Untuk visual tabel, pilih titik data dengan mengklik kanan pada sel yang relevan lalu di menu konteks, pilih Filter silang.

Anda dapat mengatur ulang filter silang dengan memilih Reset di bagian atas visual tempat filter dipilih.

Gunakan drillthrough sebagai parameter dasbor

Dengan drillthrough, Anda dapat memilih nilai pada visual dan menggunakannya untuk memfilter visual di halaman tujuan pada dasbor yang sama. Saat halaman target terbuka, nilai telah dipilih sebelumnya dalam filter yang relevan. Visual di halaman, seperti bagan garis atau sebar, difilter untuk hanya menampilkan data terkait.

Menentukan penelusuran

Untuk membuat drillthrough, pertama-tama Anda harus mengaktifkan drillthrough pada visual, kemudian tambahkan satu atau beberapa drillthrough sesuai kebutuhan.

1. Edit visual yang ingin Anda tambahi drillthrough. Pastikan tab Visual dipilih.

2. Di panel kanan, pilih Interaksi, lalu aktifkan drillthrough.

   

3. Di bagian Drillthrough, pilih Buat baru, lalu tentukan informasi berikut. Secara opsional pilih Tambahkan pasangan lain untuk menambahkan beberapa parameter untuk halaman target. Ulangi langkah ini untuk menambahkan drillthrough ke halaman lain dalam dasbor ini dengan menggunakan parameter yang berbeda.

   Bidang	Deskripsi
   Halaman tujuan	Satu atau beberapa halaman target untuk ditelusuri menggunakan parameter yang ditentukan.
   Kolom	Kolom hasil kueri yang akan digunakan sebagai nilai untuk parameter di halaman target.
   Pengaturan	Parameter yang digunakan untuk memfilter visual di halaman target menggunakan nilai kolom.
   Catatan	Deskripsi singkat opsional.

   Penting

   Pasangan kolom dan parameter harus berjenis data yang sama.

Berinteraksi dengan data Anda melalui drillthrough

Setelah drillthrough didefinisikan, Anda dapat menggunakannya untuk berinteraksi dengan data Anda. Untuk melakukannya, dalam visual atau tabel tempat Anda menentukan penelusuran, klik kanan pada titik data, lalu pilih Telusuri paling detail ke>halaman tujuan. Nilai dari titik data digunakan sebagai parameter untuk memfilter visual pada halaman target.

Untuk kembali ke halaman sumber, di kanan atas halaman tujuan, pilih Reset. Semua filter yang diberikan oleh drillthrough diatur ulang.

Gunakan pencarian filter untuk filter pilihan tunggal dan pilihan ganda.

Dalam filter pilihan tunggal dan beberapa, ketik nilai yang Anda inginkan. Filter diperbarui untuk hanya menampilkan nilai yang cocok dengan istilah pencarian.

Konten terkait

• Menyesuaikan visual dasbor Azure Data Explorer
• Menulis kueri Kusto Query Language di antarmuka web