Databricks SQL uyarıları

Önemli

Bu özellik Genel Önizleme aşamasındadır. Önizlemeler sayfasında önizleme kaydını onaylayabilirsiniz. Bkz. Azure Databricks önizlemelerini yönetme.

Bu sayfa, sorgu yürütmeyi otomatikleştirmek, özel koşulları değerlendirmek ve bu koşullar karşılandığında bildirim göndermek için Databricks SQL uyarılarını etkinleştirmeye ve kullanmaya yönelik adım adım yönergeler sağlar. Uyarılar sayesinde, iş verilerinizi proaktif olarak izleyebilir ve bildirilen değerler beklenen eşiklerin dışında olduğunda zamanında bildirim alabilirsiniz. Bir uyarıyı zamanladığınızda, ilgili sorgu çalıştırılır ve temel sorgudaki mevcut zamanlamalardan bağımsız olarak uyarı ölçütleri denetlenür. Ayrıca, geçmiş uyarı değerlendirmelerinin sonuçlarını gözden geçirmek için bir uyarı geçmişine erişebilirsiniz.

Bunun yerine eski uyarılarla çalışmayı öğrenmek için bkz. Eski uyarılar nelerdir?.

Çalışma alanınızda uyarıları etkinleştirme

Çalışma alanı yöneticileri , Önizlemeler sayfasından bu önizlemeye çalışma alanı erişimini denetleyebilir. Bu önizlemeyi etkinleştirmek mevcut uyarılarınızı etkilemez; hem bu hem de eski uyarıları paralel olarak kullanmaya devam edebilirsiniz.

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

Uyarıları'na tıklayarak uyarı listesi sayfasını açın.

• Uyarılar sekmesi varsayılan olarak açıktır ve çalışma alanında tüm uyarıları gösterir. İsme göre filtrelemek için yazabilirsiniz. Yalnızca sahibi olduğunuz uyarıları göstermek için Yalnızca uyarılarım'a tıklayın.

• Eski uyarılar sekmesi, önceki uyarı sistemi kullanılarak oluşturulan uyarıları gösterir.

• Ad her uyarının dize adını gösterir.

• Durum , uyarı durumunun TRIGGERED, OKveya ERRORolup olmadığını gösterir.

• Zamanlama , son güncelleştirme saatini veya tarihini gösterir.

• Sahip , uyarının sahibi olan kişinin kullanıcı adını gösterir.

• Oluşturma tarihi , uyarının oluşturulduğu tarihi ve saati gösterir.

  • TRIGGERED , en son yürütmede hedef sorgunuzdaki Value sütununun yapılandırdığınız Koşul ve Eşik ile karşılaştığı anlamına gelir. Uyarınız "kedilerin" 1500'in üzerinde olup olmadığını denetlerse, "kediler" 1500'in üzerinde olduğu sürece uyarınız tetiklenir.
  • OK , en son sorgu yürütmesinde Value 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 şu şekilde gösterilecektir: OK.
  • ERROR uyarı değerlendirmesi sırasında bir hata oluştuğuna işaret eder.

Uyarı oluşturma

Bu bölümdeki adımlar, aşağıdaki görüntüde gösterilen uyarının nasıl oluşturulacağını gösterir. Her bileşeni anlamak için etiketleri ve açıklamaları kullanın.

1. Sorgu düzenleyicisi: Uyarı vermek istediğiniz sorguyu yazın ve test edin.

2. Tarife: Uyarının çalışması için düzenli bir zamanlama ayarlayın.

3. Koşul: Uyarı bildirimi tetiklemesi gereken değer eşiğini seçin. Bu bölümdeki koşulu test etmek için sorguyu çalıştırabilirsiniz.

4. Bildirim: Eşik değeri beklenen aralığın dışına çıktığında hangi kullanıcıların veya bildirim hedeflerinin uyarılacağını belirtin.

5. İleri: Özel değerler ve koşullar hakkında uyarı vermek için gelişmiş ayarları kullanın.

Önemli

Genel Önizleme döneminde, uyarılar parametreleri olan sorguları desteklemez. Bkz. Eski uyarılar nelerdir?.

Uyarı oluşturmak için aşağıdaki adımları kullanın:

1. Kenar çubuğunda Uyarıları'na ve ardından Uyarı Oluştur'a tıklayın.

2. Aşağıdaki sorguyu kopyalayıp sorgu düzenleyicisine yapıştırın. Tümünü çalıştır (1000)'e tıklayın. SQL düzenleyicisiyle çalışma hakkında daha fazla bilgi edinmek için bkz. Yeni SQL düzenleyicisinde sorgu yazma ve verileri keşfetme.

   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. Koşul alanında, uyarıyı tetiklemesi gereken koşulları ayarlayın.

   

   Aşağıdaki ayarları gösterildiği gibi uygulayın:

   • Denetlenecek veri değeri olarak Topla'ya tıklayın. 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.
   • Denetlenecek sütun olarak tutar'ı seçin.
   • Uygulanacak mantıksal işleç olarak > (büyüktür) seçeneğini belirleyin.
   • Eşik değerini 4000 olarak Static value ayarlayın. Statik değer varsayılan olarak seçilidir. Değer alanına 4000 girin.

4. Uyarının önizlemesini görüntülemek ve uyarının geçerli verilerle tetiklenip tetiklemeyeceğini test etmek için Test koşulu'na tıklayın. Sağlanan ayarlar uyarıyı tetiklemelidir. Daha fazla test etmek için eşik değerini değiştirebilirsiniz.

5. Bildirimler bölümünde kullanıcı adınızı arayın ve göründüğünde üzerine tıklayın.

6. Zamanlamayı düzenle iletişim kutusunu açmak için takvim simgesi. Uyarıyı, saati 0 dakikadan 5dakikada bir çalışacak şekilde ayarlamak için açılan menüleri kullanın. Kaydet'e tıklayın. İsteğe bağlı olarak, Quartz Cron Söz Dizimizamanlamayı düzenlemek için Cron söz dizimini göster onay kutusunu seçin.

7. Uyarıyı görüntüle'ye tıklayın.

Uyarınız kaydedilir ve sağladığınız zamanlamaya göre çalışır. Bu örnekte kullanılan veriler statik olduğundan Test koşulunuzTetiklenmiş olarak döndürülürse bir sonraki çalıştırmada yeniden çalışır. Uyarı olarak bir e-posta bildirimi alırsınız. Test koşuluTamam döndürdüyse bildirim gönderilmez.

Uyarı ayrıntılarını gözden geçirme

Uyarı ayrıntılarınızı göstermek için bir sayfa açılır. Ayrıca, değerlendirme geçmişi ayrıntılarıyla birlikte bir uyarı geçmişi gösterilir. Uyarı sorgusunu hemen çalıştırmak ve sonucu bu ekranda döndürmek için Şimdi çalıştır düğmesine tıklayın.

Uyarıyı düzenlemeye devam etmek için sayfanın sağ üst köşesindeki Düzenle'ye tıklayın.

Gelişmiş ayarlar

Aşağıdaki ayarları uygulamak için Gelişmiş ayarlar'a tıklayın:

• Tamamlandığında bildir: Uyarı OK olarak döndüğünde bir bildirim gönderin.

• Bildirim sıklığı: Durum OK öğesine dönene kadar bir uyarı için düzenli aralıklarla bildirim gönderin.

• Boş sonuç durumu: Sorgu hiçbir sonuç döndürmediğinde döndürülecek özel bir durum ayarlayın.

• Şablon: Varsayılan şablonu veya özel şablonu kullanarak bildirim göndermeyi seçebilirsiniz. Aşağıdaki listede her şablon türü açıklanmaktadır:

  • 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ı (string).
       • ALERT_NAME: Uyarı adı (dize).
       • ALERT_URL: Uyarı sayfası URL'si (dize).
       • QUERY_RESULT_TABLE: Sorgu sonucu HTML tablosu (dize). Sonuçlar ilk 100 satırla sınırlıdır. YALNıZCA e-posta bildirim hedefleri HTML işleyebilir.
       • 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. YALNıZCA e-posta bildirim hedefleri HTML işleyebilir. Şablonlarda aşağıdaki etiketlere ve özniteliklere izin verilir:

       • İzin verilen etiketler: <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>

       • İzin verilen öznitelikler:

         Öznitelik	Desteklenen etiketler
         href	<a>
         title	<img>
         target	<a>
         alt	<img>
         src	<img>
         start	<b>, <blockquote>, <code>, , <del>, <em>, <hr>, <i>, <pre>, <u>

    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.

Çalışma alanı yöneticileri yeni bildirim hedefleri ayarlayabilir. Bkz. Bildirim hedeflerini yönetme.

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 ifadesi (CTE) içinde sarmalar ve sorgu sonucunu toplamak için üzerinde bir toplama sorgusu yürütür.

Örneğin, metin içeren SUM bir SELECT 1 AS column_name 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 (QUERY_RESULT_ROWS ve QUERY_RESULT_COLSgibi 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 çok sütunda uyarı

Bir sorgunun birden çok sütununa dayalı bir uyarı ayarlamak için, sorgunuz uyarı mantığını gerçekleştirebilir ve uyarıyı tetikleyecek boole değerini 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 1döndürürdrafts_count > 10000 and archived_count > 5000. Ardından, değeri 1olduğunda uyarıyı tetikleme olarak yapılandırabilirsiniz.

Ölçüm grafiklerinde uyarı

Ölçüm görünümleri, temel iş ölçümlerini izlemek ve ölçmek için tasarlandığından, bir ölçüm beklenen aralığın dışında olduğunda otomatik olarak bilgilendirilebilmeniz için uyarılarla iyi bir şekilde eşleşir. Ölçüm görünümlerindeki uyarılar, diğer veri kümelerindeki uyarılarla aynı şekilde çalışır. Sorguyu yapılandırmak için sorguyu yazarken, izlemek istediğiniz ölçüm görünümünün tam adını kullanın.

Git tümleştirmesi uyarılarla nasıl çalışır?

Uyarılarda yapılan değişiklikleri izlemek ve yönetmek için Databricks Git klasörlerini kullanabilirsiniz. Git ile uyarıları izlemek için bir Databricks Git klasörüne yerleştirin. Yeni kopyalanan uyarılar yalnızca bir kullanıcı bunlarla etkileşime geçtikten sonra uyarı listesi sayfasında veya API'de görünür. Zamanlamaları duraklatmışlardır ve kullanıcılar tarafından açıkça sürdürülmeleri gerekir.

Databricks Git klasörleri, uyarılar ve diğer çalışma alanı nesneleri için yaygın Git işlemlerini yönetmek için merkezi bir yol sağlar. Daha fazla bilgi edinmek için bkz. Azure Databricks Git klasörleri.

Eski uyarılardan farklar

Databricks SQL uyarılarının en son sürümü, birkaç temel yolla eski uyarılardan farklı davranır:

• İşler tümleştirmesi: En son sürüm henüz İşler işlem hattındaki bir uyarıya doğrudan başvurmayı desteklemez. Bu özellik yakında kullanıma sunulacaktır. Eski uyarılar İşler'de Uyarılar görev türünü destekler.
• Sorgu yeniden kullanımı: Mevcut kaydedilmiş SQL sorgusu uyarı oluşturulurken yeniden kullanılamaz. Her uyarının kendi sorgu tanımı vardır ve bu tanım doğrudan yeni uyarı düzenleyicisinde yazılabilir.
• Uyarı durumu değerleri: Uyarı durumları basitleştirilmiştir ve uyarılar artık eski uyarılardan gelen durumu desteklemez UNKNOWN . Değerlendirmeler OK, TRIGGERED veya ERROR olarak çözülür.

Geçiş yaparken hem en son uyarıları hem de eski uyarıları yan yana kullanmaya devam edebilirsiniz.

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

Uyarı izin düzeyleri için bkz . Uyarılar ACL'leri.

1. Kenar çubuğunda Uyarılar'a tıklayın.

2. Bir uyarıya tıklayın.

3. Paylaşım iletişim kutusunu açmak için uyarı ayrıntı sayfasının sağ üst köşesinde paylaş'a tıklayın.

   

4. Grupları ve kullanıcıları arayıp seçin ve izin düzeyini atayın.

5. 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. İzinler API'sini kullanarak sahipliği de aktarabilirsiniz.

1. Çalışma alanı yöneticisi olarak Azure Databricks çalışma alanınızda oturum açın.

2. Kenar çubuğunda Uyarılar'a tıklayın.

3. Bir uyarıya tıklayın.

4. Sağ üstteki Paylaş düğmesine tıklayarak Paylaşım iletişim kutusunu açın.

5. Sağ üstteki dişli simgesine tıklayın ve Yeni sahip ata'ya tıklayın.

   

6. Sahiplik atanacak kullanıcıyı seçin.

7. Onayla'yı tıklatın.