Parameter teks buku kerja

  • Artikel

Parameter kotak teks memberikan cara sederhana untuk mengumpulkan input teks dari pengguna buku kerja. Parameter tersebut digunakan ketika penggunaan menu drop-down untuk mengumpulkan input sulit dilakukan, misalnya, ambang arbitrer atau filter generik. Dengan menggunakan buku kerja, Anda bisa mendapatkan nilai default kotak teks dari kueri. Fungsionalitas ini memungkinkan skenario menarik seperti pengaturan ambang batas default berdasarkan p95 metrik.

Penggunaan umum kotak teks adalah digunakan sebagai variabel internal yang digunakan oleh kontrol buku kerja lain. Anda menggunakan kueri untuk nilai default dan membuat kontrol input tidak terlihat dalam mode baca. Misalnya, Anda mungkin menginginkan ambang berasal dari rumus, bukan pengguna, lalu menggunakan ambang tersebut dalam kueri berikutnya.

Buat parameter teks

  1. Mulai dengan buku kerja kosong dalam mode edit.

  2. Pilih Tambahkan parameter>Tambahkan Parameter.

  3. Di panel parameter baru yang terbuka, masukkan:

    1. Nama parameter: SlowRequestThreshold
    2. Jenis parameter: Text
    3. Diperlukan: checked
    4. Dapatkan data dari: None

  4. Pilih Simpan untuk membuat parameter.

    Screenshot that shows the creation of a text parameter.

Cuplikan layar ini menunjukkan tampilan buku kerja dalam mode baca:

Screenshot that shows a text parameter in read mode.

Gaya bidang parameter

Parameter teks mendukung gaya bidang berikut:

  • Standar: Bidang teks baris tunggal.

    Screenshot that shows a standard text field.

  • Kata sandi: Bidang kata sandi baris tunggal. Nilai kata sandi hanya disembunyikan di UI saat Anda mengetik. Nilai tersebut dapat diakses sepenuhnya sebagai nilai parameter saat dirujuk. Nilai tersebut disimpan secara tidak terenkripsi saat buku kerja disimpan.

    Screenshot that shows a password field.

  • Multibaris: Bidang teks multibaris dengan dukungan IntelliSense kaya dan pewarnaan sintaks untuk bahasa berikut:

    • Teks
    • Markdown
    • JSON
    • SQL
    • TypeScript
    • KQL
    • TOML

    Anda juga dapat menentukan ketinggian untuk editor multibaris.

    Screenshot that shows a multiline text field.

Referensikan parameter teks

  1. Pilih Tambahkan kueri untuk menambahkan kontrol kueri, lalu pilih sumber daya Application Insights.

  2. Dalam kotak KQL, tambahkan cuplikan ini:

    requests
| summarize AllRequests = count(), SlowRequests = countif(duration >= {SlowRequestThreshold}) by name
| extend SlowRequestPercent = 100.0 * SlowRequests / AllRequests
| order by SlowRequests desc

  3. Dengan menggunakan parameter teks bernilai 500 yang dipasangkan dengan kontrol kueri, Anda akan menjalankan kueri di bawah ini secara efektif:

    requests
| summarize AllRequests = count(), SlowRequests = countif(duration >= 500) by name
| extend SlowRequestPercent = 100.0 * SlowRequests / AllRequests
| order by SlowRequests desc

  4. Jalankan kueri untuk melihat hasilnya.

    Screenshot that shows a text parameter referenced in KQL.

Catatan

Dalam contoh di atas, {SlowRequestThreshold} mewakili nilai bilangan bulat. Jika Anda meminta string seperti {ComputerName}, Anda perlu mengubah kueri Kusto untuk menambahkan tanda kutip "{ComputerName}" agar bidang parameter dapat menerima input tanpa tanda kutip.

Atur nilai default menggunakan kueri

  1. Mulai dengan buku kerja kosong dalam mode edit.

  2. Pilih Tambahkan parameter>Tambahkan Parameter.

  3. Di panel parameter baru yang terbuka, masukkan:

    1. Nama parameter: SlowRequestThreshold
    2. Jenis parameter: Text
    3. Diperlukan: checked
    4. Dapatkan data dari: Query

  4. Dalam kotak KQL, tambahkan cuplikan ini:

    requests
| summarize round(percentile(duration, 95), 2)

    Kueri ini menetapkan nilai default kotak teks ke durasi persentil ke-95 untuk semua permintaan di aplikasi.

  5. Jalankan kueri untuk melihat hasilnya.

  6. Pilih Simpan untuk membuat parameter.

    Screenshot that shows a text parameter with a default value from KQL.

Catatan

Meskipun contoh ini mengkueri data Application Insights, pendekatan ini dapat digunakan untuk sumber data berbasis log apa pun, seperti Log Analytics dan Azure Resource Graph.

Tambahkan validasi

Untuk parameter teks standar dan kata sandi, Anda dapat menambahkan aturan validasi yang diterapkan ke bidang teks. Tambahkan regex yang valid dengan pesan kesalahan. Jika pesan diatur, pesan tersebut ditampilkan sebagai kesalahan saat bidang tidak valid.

Jika pencocokan dipilih, bidang akan valid jika nilai cocok dengan regex. Jika pencocokan tidak dipilih, bidang akan valid jika nilai tidak cocok dengan regex.

Screenshot that shows text validation settings.

Memformat data JSON

Jika JSON dipilih sebagai bahasa untuk bidang teks multibaris, bidang tersebut akan memiliki tombol yang akan memformat data JSON bidang tersebut. Anda juga dapat menggunakan pintasan Ctrl + \ untuk memformat data JSON.

Jika data berasal dari kueri, Anda dapat memilih opsi untuk memformat data JSON sebelumnya yang dikembalikan oleh kueri.

Screenshot that shows the option Pre-format JSON data.

Langkah berikutnya

Memulai Buku Kerja Azure