Databricks SQL uyarıları nelerdir?

Makale
07/11/2024

Databricks SQL uyarıları düzenli aralıklarla sorgular çalıştırır, tanımlı koşulları değerlendirir ve bir koşul karşılanırsa bildirim gönderir. İşletmenizi izlemek için uyarılar ayarlayabilir ve bildirilen veriler beklenen sınırların dışına çıktığında bildirim gönderebilirsiniz. Bir uyarının zamanlanması, temel alınan sorguyu yürütür ve uyarı ölçütlerini denetler. Bu, temel alınan sorguda mevcut olabilecek tüm zamanlamalardan bağımsızdır.

Önemli

Sorgulardan parametrelerle yararlanan uyarılar , her parametre için SQL düzenleyicisinde belirtilen varsayılan değeri kullanır.

Uyarıları görüntüleme ve düzenleme

Uyarılara erişmek için aşağıdaki seçeneklerden birini kullanın:

Uyarıları varsayılan olarak depolandıkları Giriş klasöründe görüntülemek için kenar çubuğundaKi Çalışma Alanına tıklayın. Kullanıcılar, uyarıları diğer Databricks nesneleriyle birlikte çalışma alanı tarayıcısında klasörler halinde düzenleyebilir.
Kenar çubuğundaki Uyarılar'a tıklayarak uyarı listesi sayfasını görüntüleyin.

Varsayılan olarak, nesneler ters kronolojik düzende sıralanır. Sütun başlıklarına tıklayarak listeyi yeniden sıralayabilirsiniz. Çalışma alanında tüm uyarıları görüntülemek için ekranın üst kısmındaki Tüm uyarılar sekmesine tıklayın. Sahibi olduğunuz uyarıları görüntülemek için Uyarılarım sekmesine tıklayın.

Ad her uyarının dize adını gösterir.
Durum, uyarı durumunun TRIGGERED, OK veya UNKNOWN olduğunu gösterir.
Son Güncelleştirme , son güncelleştirme saatini veya tarihini gösterir.
Oluşturma tarihi , uyarının oluşturulduğu tarihi ve saati gösterir.
- TRIGGERED, en güncel yürütmede, hedef sorgunuzdaki Değer sütununun yapılandırdığınız Koşul ve Eşik değerlerini karşıladığı anlamına gelir. Uyarınız “kediler” değerinin 1500'ün üstünde olup olmadığını kontrol ediyorsa “kediler” 1500'ün üstünde olduğu sürece uyarınız tetiklenir.
- OK, en güncel sorgu yürütmesinde, Değer sütununun yapılandırdığınız Koşul ve Eşik değerlerini karşılamadığı anlamına gelir. Bu, Uyarının daha önce tetiklenmediği anlamına gelmez. "Cats" değeriniz artık 1470 ise, uyarınız olarak OKgösterilir.
- UNKNOWN , Databricks SQL'in uyarı ölçütlerini değerlendirmek için yeterli veriye sahip olmadığı anlamına gelir. Uyarınızı oluşturduktan hemen sonra ve sorgu yürütülene kadar bu durumu görürsünüz. Bu durumu, sorgu sonucunda veri yoksa veya en güncel sorgu sonucu yapılandırdığınız Değer Sütununu içermiyorsa görürsünüz.

Uyarı oluşturma

Sorgunun tek bir sütununda uyarı oluşturmak için bu adımları izleyin.

Aşağıdakilerden birini yapın:
- Kenar çubuğunda Yeni'ye tıklayın ve Uyarı'ya tıklayın.
- Kenar çubuğunda Uyarılar'a ve + Yeni Uyarı düğmesine tıklayın.
- Kenar çubuğunda Çalışma Alanı'na ve + Uyarı Oluştur'a tıklayın.
- Kaydedilen sorgunun sağ üst köşesindeki kebap menüsüne ve + Uyarı Oluştur'a tıklayın.
Sorgu alanında bir hedef sorgu arayın.

Birden çok sütunda uyarı almak için sorgunuzu değiştirmeniz gerekir. Bkz. Uyarı toplamaları.
Tetikleyici koşulu alanında uyarıyı yapılandırın.
- Değer sütunu açılan listesi, sorgu sonucunuzun hangi alanının değerlendirilip değerlendirilmediği denetler. Uyarı koşulları sorgu sonucundaki bir sütunun ilk değerinde ayarlanabilir veya topla veya ORTALAMA gibi tek bir sütunun tüm satırları arasında bir toplama ayarlamayı seçebilirsiniz.
- İşleç açılan listesi uygulanacak mantıksal işlemi denetler.
- Eşik değeri metin girişi, belirttiğiniz Koşul kullanılarak Değer sütunuyla karşılaştırılır.
Uyarıyı önizlemek ve uyarının geçerli verilerle tetiklenip tetiklemeyeceğini test etmek için Uyarıyı önizle'ye tıklayın.
Uyarı tetiklendiğinde bildirim gönder alanında uyarınız tetiklendiğinde kaç bildirim gönderileceğini seçin:
- Yalnızca bir kez: Uyarı durumu olarak OK TRIGGEREDdeğiştiğinde bildirim gönderin.
- Her uyarı değerlendirildiğinde: Önceki değerlendirmede uyarı durumu TRIGGERED ne olursa olsun bir bildirim gönderin.
- En çok her: Uyarı durumu belirli bir aralıkta olduğunda TRIGGERED bildirim gönderin. Bu seçenek, sık tetikleyen uyarılar için istenmeyen posta bildirimlerini önlemenizi sağlar.
Hangi bildirim ayarını seçerseniz seçin, durum 'dan 'a veya 'dan OK TRIGGERED 'a TRIGGERED OKher geçtiğinde bir bildirim alırsınız. Zamanlama ayarları, durum bir yürütmeden diğerine kalırsa TRIGGERED kaç bildirim alacağınızı etkiler. Ayrıntılar için bkz . Bildirim sıklığı.
Şablon açılan listesinden bir şablon seçin:
- Varsayılan şablonu kullan: Uyarı bildirimi, Uyarı yapılandırma ekranının ve Sorgu ekranının bağlantılarını içeren bir iletidir.
- Özel şablon kullan: Uyarı bildirimi uyarı hakkında daha ayrıntılı bilgiler içerir.
  1. Konu ve gövde için giriş alanlarından oluşan bir kutu görüntülenir. Tüm statik içerikler geçerlidir ve yerleşik şablon değişkenlerini birleştirebilirsiniz:
    - ALERT_STATUS: Değerlendirilen uyarı durumu (dize).
    - ALERT_CONDITION: Uyarı koşulu işleci (dize).
    - ALERT_THRESHOLD: Uyarı eşiği (dize veya sayı).
    - ALERT_COLUMN: Uyarı sütun adı (dize).
    - ALERT_NAME: Uyarı adı (dize).
    - ALERT_URL: Uyarı sayfası URL'si (dize).
    - QUERY_NAME: İlişkili sorgu adı (dize).
    - QUERY_URL: İlişkili sorgu sayfası URL'si (dize).
    - QUERY_RESULT_TABLE: Sorgu sonucu HTML tablosu (dize).
    - QUERY_RESULT_VALUE: Sorgu sonucu değeri (dize veya sayı).
    - QUERY_RESULT_ROWS: Sorgu sonuç satırları (değer dizisi).
    - QUERY_RESULT_COLS: Sorgu sonuç sütunları (dize dizisi).
    Örneğin, örnek bir konu şu olabilir: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.
  2. Özel şablondaki iletileri biçimlendirmek için HTML kullanabilirsiniz. Şablonlarda aşağıdaki etiketlere ve özniteliklere izin verilir:
    - Etiketler: <a>, <abbr>, <acronym>, , <b>, <blockquote>, <body>, <br>, <code>, , <em><div>, <h2><h1>, <h3>, <h4>><html><li><hr><h5<h6>><i><head, <ol>, , <p>, <span>, , <strong>, , <table>, , <td><th><tr><tbody><ul>
    - Öznitelikler: href (için <a>), title (için <a>, <abbr>, <acronym>)
  3. İşlenen sonucun önizlemesini görüntülemek için Önizleme iki durumlu düğmesini tıklatın.
    
    Önemli
    
    Önizleme, şablon değişkenlerinin doğru işlendiğini doğrulamak için kullanışlıdır. Her bildirim hedefi bildirimleri farklı şekilde görüntüleyebildiği için nihai bildirim içeriğinin doğru bir gösterimi değildir.
  4. Değişiklikleri Kaydet düğmesine tıklayın.
Uyarı Oluştur'a tıklayın.
Zamanlama Ekle'ye tıklayın.
- Sıklığı, dönemi, başlangıç saatini ve saat dilimini belirtmek için açılan liste seçicileri kullanın. İsteğe bağlı olarak, Quartz Cron Söz Dizimi'nde zamanlamayı düzenlemek için Cron söz dizimini göster onay kutusunu seçin.
- İsteğe bağlı ayarları göstermek için Diğer seçenekler'i seçin. Şunları da seçebilirsiniz:
  - Zamanlama için bir ad.
  - Sorguyu desteklemek için bir SQL ambarı. Varsayılan olarak, geçici sorgu yürütme için kullanılan SQL ambarı zamanlanmış bir iş için de kullanılır. Zamanlanmış sorguyu çalıştırmak üzere farklı bir ambar seçmek için bu isteğe bağlı ayarı kullanın.
Zamanlama ekle iletişim kutusunda Hedefler sekmesine tıklayın.
- Kullanılabilir bir bildirim hedefi seçmek için açılan listeyi kullanın. Alternatif olarak, kişi eklemek için bir kullanıcı adı yazmaya da başlayabilirsiniz.
Önemli

Bu adımı atlarsanız uyarı tetiklendiğinde size bildirim gösterilmez .
Oluştur’a tıklayın. Kaydedilen uyarı ve bildirim ayrıntılarınız ekranda görünür.
Zamanlamayı paylaşın.
- Listelenen zamanlamanın sağındaki kebap menüsünü seçin ve Zamanlama izinlerini düzenle'yi seçin.
- İletişim kutusundaki açılan menüden bir kullanıcı veya grup seçin.
- Aşağıdaki zamanlama izinlerinden birini seçin:
  - İzİn YOK: İzin verilmedi. İzinleri olmayan kullanıcılar, abone olsalar veya listelenen bildirim hedeflerine dahil olsalar bile zamanlamanın mevcut olduğunu göremez.
  - GÖRÜNTÜLEYEBILIR: Zamanlanmış çalıştırma sonuçlarını görüntüleme izni verir.
  - ÇALıŞTıRMAYı YÖNETEBILIR: Zamanlanmış çalıştırma sonuçlarını görüntüleme izni verir.
  - YÖNETİlEBILIR: Zamanlamaları görüntüleme, değiştirme ve silme izni verir. Bu izin, çalışma aralığında değişiklik yapmak, abone listesini güncelleştirmek ve zamanlamayı duraklatmak veya duraklatmak için gereklidir.
  - IS OWNER: CAN MANAGE'in tüm izinlerini verir. Ayrıca, pano sorgularını çalıştırmak için zamanlama sahibinin kimlik bilgileri kullanılır. Sahibi yalnızca çalışma alanı yöneticisi değiştirebilir.
Önemli

Uyarılar ve zamanlamalar için izinler ayrıdır. Zamanlanmış çalıştırma sonuçlarını görüntüleyebilmeleri için bildirim hedefleri listesindeki kullanıcılara ve gruplara erişim izni verin.
Uyarıyı paylaşın.
- Sayfanın sağ üst kısmına tıklayın .
- Uyarıya erişimi olması gereken kullanıcıları veya grupları ekleyin.
- Uygun izin düzeyini seçin ve Ekle'ye tıklayın.

Önemli

CAN MANAGE, zamanlamaları görüntüleme, değiştirme ve silme izni verir. Bu izin, çalışma aralığında değişiklik yapmak, bildirim hedef listesini güncelleştirmek ve zamanlamayı duraklatmak veya duraklatmak için gereklidir.

Uyarı izin düzeyleri hakkında daha fazla bilgi için bkz . Uyarılar ACL'leri.

Uyarı toplamaları

Uyarıdaki toplama işlemi, uyarıya eklenen Databricks SQL sorgusunun özgün SQL'ini değiştirerek çalışır. Uyarı, özgün sorgu metnini ortak bir tablo ifadesinde (CTE) sarmalar ve sorgu sonucunu toplamak için üzerinde bir sarmalama toplama sorgusu gerçekleştirir.

Örneğin, metin içeren SELECT 1 AS column_name bir SUM sorguya eklenmiş bir uyarıda toplama, uyarı her yenilendiğinde çalıştırılan değiştirilmiş SQL'in şöyle olacağı anlamına gelir: WITH q AS (SELECT 1 AS column_name) SELECT SUM(column_name) FROM q.

Bu, bir uyarıda toplama olduğunda özgün sorgu sonucunun (önceden toplanmış) uyarı özel gövdesinde (ve QUERY_RESULT_COLSgibi QUERY_RESULT_ROWS parametrelerle) gösterilemeyeceği anlamına gelir. Bunun yerine, bu değişkenler yalnızca son, toplama sonrası sorgu sonucunu görüntüler.

Not

Toplamalarla ilgili tüm tetikleyici koşulları API tarafından desteklenmez.

Birden fazla sütun için uyarılar

Sorgunun birden çok sütununu temel alan bir uyarı ayarlamak için, sorgunuz uyarı mantığını uygulayabilir ve uyarının tetikleyebileceği boole değeri döndürebilir. Örneğin:

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

Bu sorgu, olduğunda drafts_count > 10000 and archived_count > 5000döndürür1. Ardından, değeri 1olduğunda uyarıyı tetikleme olarak yapılandırabilirsiniz.

Bildirim sıklığı

Databricks SQL, Uyarı durumunun olarak değiştirildiğini OK algılayan veya tam tersi olan bildirimleri seçtiğiniz bildirim hedeflerine TRIGGERED gönderir. Her gün bir kez çalıştırılacak şekilde zamanlanmış bir sorguda Bir Uyarı'nın yapılandırıldığı bu örneği düşünün. Uyarının günlük durumu aşağıdaki tabloda gösterilir. Pazartesi gününden önce uyarı durumu şeklindeydi OK.

Gün	Uyarı Durumu
Pazartesi	Tamam
Salı	Tamam
Çarşamba	TETİK -LENEN
Perşembe	TETİK -LENEN
Cuma	TETİK -LENEN
Cumartesi	TETİK -LENEN
Pazar	Tamam

Bildirim sıklığı olarak ayarlanırsa Just OnceDatabricks SQL Çarşamba günü durum, pazar günü geri döndüğünde durum ile OK TRIGGERED tekrar değiştirildiğinde bir bildirim gönderir. Uyarı durumu bu günlerde yapılan yürütmeler arasında değişmediğinden, bunu özel olarak yapılandırdığınız sürece Perşembe, Cuma veya Cumartesi günleri uyarı göndermez.

Uyarı izinlerini yapılandırma ve uyarı sahipliğini aktarma

Sorguları paylaşmak için sorgu üzerinde en azından CAN MANAGE izniniz olmalıdır. Uyarı izin düzeyleri için bkz . Uyarılar ACL'leri.

Kenar çubuğunda Uyarılar'a tıklayın.
Bir uyarıya tıklayın.
Sağ üstteki düğmeye tıklayarak Paylaşım iletişim kutusunu açın.
Grupları ve kullanıcıları arayıp seçin ve izin düzeyini atayın.
Ekle'yi tıklatın.

Uyarının sahipliğini aktarma

Bir uyarıyı kaydettiğinizde, uyarının sahibi olursunuz. Bir uyarının sahibi çalışma alanından kaldırılırsa, uyarının artık sahibi yoktur. Çalışma alanı yöneticisi kullanıcısı, bir uyarının sahipliğini farklı bir kullanıcıya aktarabilir. Hizmet sorumlularına ve gruplara bir uyarının sahipliği atanamaz. İzinler API'sini kullanarak sahipliği de aktarabilirsiniz.

Çalışma alanı yöneticisi olarak Azure Databricks çalışma alanınızda oturum açın.
Kenar çubuğunda Uyarılar'a tıklayın.
Bir uyarıya tıklayın.
Sağ üstteki Paylaş düğmesine tıklayarak Paylaşım iletişim kutusunu açın.
Sağ üstteki dişli simgesine tıklayın ve Yeni sahip ata'ya tıklayın.
Sahiplik atanacak kullanıcıyı seçin.
Onayla'yı tıklatın.

Aracılığıyla paylaş