Bagikan melalui

Pemberitahuan Databricks SQL

Penting

Fitur ini ada di Beta.

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

Untuk sebagian besar pelanggan, admin ruang kerja dapat mengontrol akses ruang kerja ke pratinjau ini dari halaman Pratinjau. Jika Anda tidak melihat versi pemberitahuan ini di ruang kerja Anda, hubungi tim akun Databricks Anda.

Mengaktifkan pratinjau ini tidak berdampak pada peringatan yang ada; Anda dapat terus menggunakan peringatan ini dan peringatan lama 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 UNKNOWN.

  • 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 peringatan Anda memeriksa apakah "kucing" di atas 1500, peringatan Anda akan dipicu selama "kucing" 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 1470, pemberitahuan Anda akan ditampilkan sebagai OK.
    • UNKNOWN menunjukkan bahwa Databricks SQL tidak memiliki cukup data untuk mengevaluasi kriteria pemberitahuan. Status ini muncul segera setelah membuat peringatan Anda dan tetap ada hingga kueri dijalankan. Status ini juga digunakan jika tidak ada data dalam hasil kueri atau jika hasil kueri terbaru tidak menyertakan Kolom Nilai yang Anda konfigurasikan.
    • 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. Himpunan data: Tulis dan uji kueri yang ingin Anda beri tahu.
  2. Keadaan: Pilih ambang nilai yang harus memicu pemberitahuan pemberitahuan. Anda bisa menjalankan kueri untuk menguji kondisi dari bagian ini.
  3. Jadwal: Atur jadwal berkala agar pemberitahuan berjalan.
  4. Pemberitahuan: Tentukan apakah pengguna atau tujuan pemberitahuan harus diberitahu ketika nilai ambang batas berada di luar rentang yang diharapkan.
  5. Maju: Gunakan pengaturan tingkat lanjut untuk memperingatkan nilai dan kondisi khusus.

Penting

Selama periode Beta, 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 Himpunan data .

    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. Gunakan menu drop-down Jadwal untuk mengatur pemberitahuan sehingga dijalankan Setiap 5menit dari 0 menit setelah jam. Opsional, pilih kotak centang Tampilkan Sintaks Cron untuk mengedit jadwal di dalam Sintaks Cron Quartz.

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

  7. Klik Buat.

Pemberitahuan Anda disimpan dan akan berjalan sesuai 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 akan 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 pada 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_NAME: Nama kueri terkait (karakter).
        • QUERY_URL: URL halaman kueri terkait (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: <a>, , <abbr>, <acronym><b>, <blockquote>, <body>, <br>, <code>, <div>, <em><h1>, , <h2>, , <h3>, <h4><h5><h6><head><hr><html><i><li><ol><p><span><strong><table><tbody><td><th><tr><ul>
        • Atribut: href (untuk <a>), judul (untuk <a>, <abbr>, <acronym>)

      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 lebih lanjut, lihat Integrasi Git untuk folder Git Databricks.

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. Perwakilan layanan dan grup tidak dapat diberi kepemilikan pemberitahuan. 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.