Bagikan melalui

Pemberitahuan Databricks SQL

Penting

Fitur ini ada di Pratinjau Umum.

Halaman ini menyediakan panduan langkah demi langkah untuk mengaktifkan dan menggunakan pemberitahuan Databricks SQL untuk mengotomatiskan eksekusi kueri, mengevaluasi kondisi kustom, dan memberikan pemberitahuan saat kondisi tersebut terpenuhi. Dengan pemberitahuan, Anda dapat secara proaktif memantau data bisnis Anda dan menerima pemberitahuan tepat waktu setiap kali nilai yang dilaporkan berada di luar ambang yang diharapkan. Saat Anda menjadwalkan pemberitahuan, kueri terkait berjalan dan kriteria pemberitahuan diperiksa, terlepas dari jadwal yang ada pada kueri yang mendasarinya. Selain itu, Anda dapat mengakses riwayat pemberitahuan untuk meninjau hasil evaluasi pemberitahuan sebelumnya.

Untuk mempelajari cara bekerja dengan pemberitahuan warisan, lihat Apa itu pemberitahuan warisan?.

Mengaktifkan pemberitahuan di ruang kerja Anda

Admin ruang kerja dapat mengontrol akses ruang kerja ke pratinjau ini dari halaman Pratinjau. Mengaktifkan pratinjau ini tidak memengaruhi pemberitahuan yang ada; Anda dapat terus menggunakan pemberitahuan ini dan warisan secara paralel.

Melihat dan mengatur pemberitahuan

Klik Alerts IconAlerts IconPemberitahuan di bar samping untuk membuka halaman daftar pemberitahuan.

Halaman daftar pemberitahuan.

  • Tab Pemberitahuan terbuka secara default dan memperlihatkan semua pemberitahuan di ruang kerja. Anda dapat mengetik untuk memfilter menurut nama. Klik Hanya pemberitahuan saya untuk hanya menampilkan pemberitahuan di mana Anda adalah pemiliknya.

  • Tab Pemberitahuan warisan memperlihatkan pemberitahuan yang dibuat menggunakan sistem pemberitahuan sebelumnya.

  • Nama menunjukkan nama karakter dari setiap peringatan.

  • Status menunjukkan apakah status pemberitahuan adalah TRIGGERED, OK, atau ERROR.

  • Jadwal memperlihatkan waktu atau tanggal terakhir yang diperbarui.

  • Pemilik menunjukkan nama pengguna orang yang memiliki pemberitahuan.

  • Dibuat pada menampilkan tanggal dan waktu pemberitahuan dibuat.

    • TRIGGERED berarti bahwa pada eksekusi terbaru, kolom Nilai dalam kueri target Anda memenuhi Kondisi dan Ambang Yang Anda konfigurasikan. Jika pemberitahuan Anda memeriksa apakah "kucing" di atas 1500, pemberitahuan Anda akan tetap dipicu selama "kucing" berada di atas 1500.
    • OK berarti bahwa pada eksekusi kueri terbaru, kolom Nilai tidak memenuhi Kondisi dan Ambang Yang Anda konfigurasikan. Ini tidak berarti bahwa Pemberitahuan sebelumnya tidak dipicu. Jika nilai "cats" Anda sekarang adalah 1470, pemberitahuan Anda akan ditampilkan sebagai OK.
    • ERROR menunjukkan bahwa terjadi kesalahan selama evaluasi pemberitahuan.

Membuat peringatan

Langkah-langkah di bagian ini membimbing Anda melalui cara membuat peringatan yang diperlihatkan dalam gambar berikut. Gunakan label dan penjelasan untuk memahami setiap komponen.

UI buat pemberitahuan ditampilkan dengan label bernomor yang mengidentifikasi bagian yang berbeda.

  1. Editor kueri: Tulis dan uji kueri yang ingin Anda berikan peringatan.

  2. Jadwal: Atur jadwal berkala agar pemberitahuan berjalan.

  3. Keadaan: Pilih ambang nilai yang harus memicu pemberitahuan pemberitahuan. Anda bisa menjalankan kueri untuk menguji kondisi dari bagian ini.

  4. Pemberitahuan: Menunjukkan pengguna atau tujuan pemberitahuan mana yang harus diberi tahu saat nilai ambang batas berada di luar rentang yang diharapkan.

  5. Maju: Gunakan pengaturan tingkat lanjut untuk memperingatkan nilai dan kondisi khusus.

Penting

Selama periode Pratinjau Publik, peringatan tidak mendukung kueri dengan parameter. Lihat Apa itu pemberitahuan warisan?.

Gunakan langkah-langkah berikut untuk membuat pemberitahuan:

  1. Klik Alerts IconAlerts IconPemberitahuan di bar samping dan klik Buat Pemberitahuan.

  2. Salin dan tempel kueri berikut ini di editor kueri. Klik Jalankan semua (1000). Untuk mempelajari selengkapnya tentang bekerja dengan editor SQL, lihat Menulis kueri dan menjelajahi data di editor SQL baru.

    SELECT
  to_date(tpep_pickup_datetime) as date,
  SUM(fare_amount) as amount
FROM
  `samples`.`nyctaxi`.`trips`
GROUP BY
  ALL
ORDER BY
  1 DESC

  3. Di bidang Kondisi , atur kondisi yang harus memicu pemberitahuan.

    Bidang kondisi dengan pengaturan yang diterapkan seperti dalam teks berikut.

    Terapkan pengaturan berikut seperti yang diperlihatkan:

    • Pilih Jumlah sebagai nilai data untuk diperiksa. Kondisi pemberitahuan dapat diatur pada nilai pertama kolom dalam hasil kueri, atau Anda bisa memilih untuk mengatur agregasi di semua baris kolom tunggal, seperti SUM atau AVERAGE.
    • Pilih jumlah sebagai kolom yang akan diperiksa.
    • Pilih > (lebih besar dari) sebagai operator logis yang akan diterapkan.
    • Atur nilai ambang ke Static value 4000. Nilai statis dipilih secara default. Masukkan 4000 ke dalam bidang nilai.

  4. Klik Uji kondisi untuk mempratinjau pemberitahuan dan menguji apakah pemberitahuan akan dipicu dengan data saat ini. Pengaturan yang disediakan harus memicu pemberitahuan. Anda dapat mengubah nilai ambang batas untuk menguji lebih lanjut.

  5. Di bagian Pemberitahuan , cari nama pengguna Anda dan klik saat muncul.

  6. Klik ikon Kalender. ikon kalender untuk membuka dialog Edit jadwal . Gunakan menu drop-down untuk mengatur pemberitahuan agar berjalan Setiap 5menit dari 0 menit setelah jam. Kliklah Simpan. Opsional, pilih kotak centang Tampilkan Sintaks Cron untuk mengedit jadwal di dalam Sintaks Cron Quartz.

  7. Klik Tampilkan pemberitahuan.

Pemberitahuan Anda disimpan dan berjalan pada jadwal yang Anda berikan. Data yang digunakan dalam contoh ini bersifat statis, jadi jika kondisi Pengujian Anda dikembalikan sebagai Dipicu, data tersebut akan kembali saat berjalan lagi di lain waktu. Anda menerima pemberitahuan email sebagai pemberitahuan. Jika kondisi Pengujian mengembalikan OK, tidak ada pemberitahuan yang dikirim.

Meninjau perincian peringatan

Halaman terbuka untuk menampilkan detail pemberitahuan Anda. Selain itu, riwayat peringatan ditampilkan dengan detail riwayat evaluasi. Klik tombol Jalankan sekarang untuk segera menjalankan kueri pemberitahuan dan mengembalikan hasilnya di layar ini.

Klik Edit di sudut kanan atas halaman untuk terus mengedit pemberitahuan.

Pengaturan tingkat lanjut

Klik Pengaturan tingkat lanjut untuk menerapkan pengaturan berikut:

  • Beri tahu saat OK: Kirim pemberitahuan saat peringatan kembali sebagai OK.
  • Frekuensi pemberitahuan: Kirim pemberitahuan secara berkala pada pemberitahuan hingga status kembali ke OK.
  • Status hasil kosong: Atur status khusus untuk dikembalikan saat kueri tidak mengembalikan hasil.
  • Templat: Anda dapat memilih untuk mengirim pemberitahuan menggunakan templat default atau templat kustom. Daftar berikut menjelaskan setiap jenis templat:
    • Gunakan pola dasar default: Pemberitahuan peringatan adalah pesan dengan link ke layar konfigurasi Peringatan dan layar Kueri.
    • Gunakan pola dasar kustom: Pemberitahuan peringatan mencakup informasi yang lebih spesifik tentang peringatan.

      1. Sebuah kotak menampilkan, yang terdiri dari bidang input untuk subjek dan tubuh. Konten statik apa pun valid, dan Anda dapat menggabungkan variabel pola dasar bawaan:

        • ALERT_STATUS: Status peringatan evaluasi (karakter).
        • ALERT_CONDITION: Operator kondisi peringatan (karakter).
        • ALERT_THRESHOLD: Ambang batas peringatan (karakter atau angka).
        • ALERT_COLUMN: Nama kolom pemberitahuan (string).
        • ALERT_NAME: Nama peringatan (karakter).
        • ALERT_URL: URL halaman peringatan (karakter).
        • QUERY_RESULT_TABLE: Tabel HTML hasil kueri (string). Hasil dibatasi hingga 100 baris pertama. Hanya tujuan pemberitahuan email yang dapat merender HTML.
        • QUERY_RESULT_VALUE: Nilai hasil kueri (karakter atau angka).
        • QUERY_RESULT_ROWS: Baris hasil kueri (array nilai).
        • QUERY_RESULT_COLS: Kolom hasil kueri (array string).

        Subjek contoh, untuk instans, bisa: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.

      2. Anda dapat menggunakan HTML untuk memformat pesan dalam templat kustom. Hanya tujuan pemberitahuan email yang dapat merender HTML. Tag dan atribut berikut diizinkan dalam templat:

        • Tag yang diizinkan: <a>, <b>, <blockquote>, <br>, <code>, <del>, <div>, <em>, <h1>, <h2>, <h3>, <h4>, <h5>, <h6>, <hr>, <i>, <img>, <li>, <ol>, <p>, <pre>, <span>, <table>, <thread>, <tbody>, <td>, <th>, <tr>, <u>, <ul>

        • Atribut yang diizinkan:

          Atribut Tag yang didukung
          href <a>
          title <img>
          target <a>
          alt <img>
          src <img>
          start <b>, <blockquote><code>, <del>, <em>, <hr>, <i>, <pre>, <u>

      3. Klik tombol dwiarah Pratinjau untuk melihat pratinjau hasil yang dirender.

        Penting

        Pratinjau berguna untuk memverifikasi bahwa variabel pola dasar dirender dengan benar. Ini bukan representasi yang akurat dari konten pemberitahuan akhirnya, karena setiap tujuan pemberitahuan dapat menampilkan pemberitahuan secara berbeda.

Admin ruang kerja dapat menyiapkan tujuan pemberitahuan baru. Lihat Mengelola tujuan pemberitahuan.

Agregasi pemberitahuan

Agregasi pada pemberitahuan berfungsi dengan memodifikasi SQL asli kueri Databricks SQL yang dilampirkan ke pemberitahuan. Pemberitahuan membungkus teks kueri asli dalam ekspresi tabel umum (CTE) dan melakukan kueri agregasi pembungkusan di atasnya untuk menggabungkan hasil kueri.

Sebagai contoh, agregasi SUM pada pemberitahuan yang dilampirkan ke kueri dengan teks SELECT 1 AS column_name berarti bahwa setiap kali pemberitahuan di-refresh, SQL yang dimodifikasi yang berjalan adalah: WITH q AS (SELECT 1 AS column_name) SELECT SUM(column_name) FROM q.

Ini berarti bahwa hasil kueri asli (pra-agregat) tidak dapat ditampilkan dalam isi kustom pemberitahuan (dengan parameter seperti QUERY_RESULT_ROWS dan QUERY_RESULT_COLS) setiap kali ada agregasi pada pemberitahuan. Sebaliknya, variabel tersebut hanya akan menampilkan hasil kueri pasca-agregasi akhir.

Catatan

Semua kondisi pemicu yang terkait dengan agregasi tidak didukung oleh API.

Pemberitahuan pada beberapa kolom

Untuk mengatur pemberitahuan berdasarkan beberapa kolom kueri, kueri Anda dapat mengimplementasikan logika pemberitahuan dan mengembalikan nilai boolean agar pemberitahuan dapat dipicu. Contohnya:

SELECT CASE WHEN drafts_count > 10000 AND archived_count > 5000 THEN 1 ELSE 0 END
FROM (
SELECT sum(CASE WHEN is_archived THEN 1 ELSE 0 END) AS archived_count,
sum(CASE WHEN is_draft THEN 1 ELSE 0 END) AS drafts_count
FROM queries) data

Kueri ini kembali 1 saat drafts_count > 10000 and archived_count > 5000. Kemudian Anda dapat mengonfigurasi peringatan untuk memicu saat nilainya 1.

Pemberitahuan tentang tampilan metrik

Karena tampilan metrik dirancang untuk melacak dan mengukur metrik bisnis inti, metrik tersebut dipasangkan dengan baik dengan pemberitahuan sehingga Anda dapat secara otomatis diberi tahu saat metrik berada di luar rentang yang diharapkan. Pemberitahuan tentang tampilan metrik berfungsi dengan cara yang sama seperti pemberitahuan pada himpunan data lainnya. Saat Anda menulis kueri untuk konfigurasi, gunakan nama lengkap dari tampilan metrik yang ingin Anda pantau.

Cara kerja integrasi Git dengan pemberitahuan

Anda dapat menggunakan folder Databricks Git untuk melacak dan mengelola perubahan pada pemberitahuan. Untuk melacak pemberitahuan dengan Git, letakkan di folder Databricks Git. Pemberitahuan yang baru dikloning hanya muncul di halaman daftar pemberitahuan atau API setelah pengguna berinteraksi dengannya. Mereka telah menjeda jadwal dan perlu dilanjutkan secara eksplisit oleh pengguna.

Folder Databricks Git menyediakan cara terpusat untuk mengelola operasi Git umum untuk pemberitahuan dan objek ruang kerja lainnya. Untuk mempelajari selengkapnya, lihat Folder Git Azure Databricks.

Perbedaan dari pemberitahuan lama

Versi terbaru pemberitahuan Databricks SQL berperilaku berbeda dari pemberitahuan lama dengan beberapa cara utama.

  • Integrasi pekerjaan: Versi terbaru belum mendukung secara langsung merujuk pemberitahuan di alur Pekerjaan. Fitur ini akan segera hadir. Pemberitahuan warisan mendukung jenis tugas Pemberitahuan di Pekerjaan.
  • Penggunaan kembali kueri: Kueri SQL yang disimpan tidak dapat digunakan kembali saat membuat pemberitahuan. Setiap pemberitahuan memiliki definisi kuerinya, yang dapat ditulis langsung di editor pemberitahuan baru.
  • Nilai status pemberitahuan: Status pemberitahuan disederhanakan dan pemberitahuan tidak lagi mendukung UNKNOWN status dari pemberitahuan warisan. Evaluasi dihasilkan menjadi OK, TRIGGERED, atau ERROR.

Anda dapat terus menggunakan pemberitahuan terbaru dan pemberitahuan warisan secara berdampingan saat Anda bertransisi.

Mengonfigurasi izin pemberitahuan dan mentransfer kepemilikan pemberitahuan

Untuk tingkat izin pemberitahuan, lihat ACL Pemberitahuan.

  1. Di bar samping, klik Pemberitahuan.

  2. Klik peringatan.

  3. Klik Bagikan di sudut kanan atas halaman detail pemberitahuan untuk membuka dialog Berbagi .

    Mengelola izin pemberitahuan

  4. Cari dan pilih grup dan pengguna, dan tetapkan tingkat izin.

  5. Klik Tambahkan.

Mentransfer kepemilikan peringatan

Saat menyimpan pemberitahuan, Anda menjadi pemilik pemberitahuan. Jika pemilik pemberitahuan dihapus dari ruang kerja, pemberitahuan tidak lagi memiliki pemilik. Pengguna admin ruang kerja dapat mentransfer kepemilikan pemberitahuan ke pengguna lain. Anda juga dapat mentransfer kepemilikan menggunakan API Izin.

  1. Sebagai admin ruang kerja, masuk ke ruang kerja Azure Databricks Anda.

  2. Di bar samping, klik Pemberitahuan.

  3. Klik peringatan.

  4. Klik tombol Bagikan di kanan atas untuk membuka dialog Berbagi.

  5. Klik ikon gerigi di kanan atas dan klik Tetapkan pemilik baru.

    Tetapkan pemilik baru

  6. Pilih pengguna yang akan ditetapkan kepemilikannya.

  7. Klik Konfirmasi.

  • Last updated on