ما هي تنبيهات Databricks SQL؟

تقوم تنبيهات Databricks SQL بتشغيل الاستعلامات بشكل دوري، وتقييم الشروط المحددة، وإرسال الإشعارات إذا تم استيفاء شرط. يمكنك إعداد تنبيهات لمراقبة عملك وإرسال الإعلامات عندما تقع البيانات المبلغ عنها خارج الحدود المتوقعة. جدولة تنبيه ينفذ الاستعلام الأساسي الخاص به ويتحقق من معايير التنبيه. هذا مستقل عن أي جدول زمني قد يكون موجودا في الاستعلام الأساسي.

هام

• تستخدم التنبيهات التي تستفيد من الاستعلامات مع المعلمات القيمة الافتراضية المحددة في محرر SQL لكل معلمة.

عرض التنبيهات وتنظيمها

استخدم أحد الخيارات التالية للوصول إلى التنبيهات:

• انقر فوق مساحة العمل في الشريط الجانبي لعرض التنبيهات في مجلد الصفحة الرئيسية، حيث يتم تخزينها بشكل افتراضي. يمكن للمستخدمين تنظيم التنبيهات في مجلدات في مستعرض مساحة العمل مع كائنات Databricks الأخرى.
• انقر فوق Alerts في الشريط الجانبي لعرض صفحة قائمة التنبيهات.

بشكل افتراضي، يتم فرز الكائنات بترتيب زمني عكسي. يمكنك إعادة ترتيب القائمة بالنقر فوق عناوين الأعمدة. انقر فوق علامة التبويب جميع التنبيهات بالقرب من أعلى الشاشة لعرض جميع التنبيهات في مساحة العمل. انقر فوق علامة التبويب تنبيهاتي لعرض التنبيهات حيث أنت المالك.

• يظهر الاسم اسم سلسلة كل تنبيه.
• توضح الحالة ما إذا كانت حالة التنبيه هي TRIGGEREDأو OKأو UNKNOWN.
• يعرض التحديث الأخير آخر وقت أو تاريخ تم تحديثه.
• يظهر تاريخ ووقت إنشاء التنبيه الذي تم إنشاؤه في .
  • TRIGGERED يعني أنه في التنفيذ الأخير، استيفاء عمود القيمة في الاستعلام الهدف الشرط والحد الذي قمت بتكوينه. إذا تحقق تنبيهك مما إذا كانت "القطط" أعلى من 1500، فسيتم تشغيل التنبيه طالما أن "القطط" أعلى من 1500.
  • OK يعني أنه في تنفيذ الاستعلام الأخير، لم يفي عمود القيمة بالشرط والحد الذي قمت بتكوينه. لا يعني هذا أن التنبيه لم يتم تشغيله مسبقا. إذا كانت قيمة "cats" الخاصة بك الآن 1470، فسيظهر التنبيه الخاص بك على أنه OK.
  • UNKNOWN يعني أن Databricks SQL ليس لديها بيانات كافية لتقييم معايير التنبيه. سترى هذه الحالة مباشرة بعد إنشاء التنبيه وحتى يتم تنفيذ الاستعلام. سترى أيضا هذه الحالة إذا لم تكن هناك بيانات في نتيجة الاستعلام أو إذا كانت أحدث نتيجة استعلام لا تتضمن عمود القيمة الذي قمت بتكوينه.

إنشاء تنبيه

اتبع هذه الخطوات لإنشاء تنبيه على عمود واحد من استعلام.

1. قم بأحد الإجراءات التالية:

   • انقر فوق جديد في الشريط الجانبي وحدد تنبيه.
   • انقر فوق تنبيهات في الشريط الجانبي وانقر فوق الزر + تنبيه جديد.
   • انقر فوق مساحة العمل في الشريط الجانبي وانقر فوق + إنشاء تنبيه.
   • انقر فوق قائمة kebab في الزاوية العلوية اليسرى من استعلام محفوظ وانقر فوق + Create Alert.

2. في حقل الاستعلام ، ابحث عن استعلام هدف.

   

   للتنبيه على أعمدة متعددة، تحتاج إلى تعديل الاستعلام. راجع تجميعات التنبيه.

3. في حقل شرط المشغل، قم بتكوين التنبيه.

   • تتحكم القائمة المنسدلة عمود القيمة في حقل نتيجة الاستعلام الذي يتم تقييمه. يمكن تعيين شروط التنبيه على القيمة الأولى لعمود في نتيجة الاستعلام، أو يمكنك اختيار تعيين تجميع عبر جميع صفوف عمود واحد، مثل SUM أو AVERAGE.

     

   • تتحكم القائمة المنسدلة عامل التشغيل في العملية المنطقية التي سيتم تطبيقها.

   • تتم مقارنة إدخال نص قيمة الحد بعمود القيمة باستخدام الشرط الذي تحدده.

   

4. انقر فوق معاينة التنبيه لمعاينة التنبيه واختبار ما إذا كان التنبيه سيتم تشغيله بالبيانات الحالية.

5. في الحقل When alert is triggered، send notification ، حدد عدد الإعلامات التي يتم إرسالها عند تشغيل التنبيه:

   • مرة واحدة فقط: أرسل إعلاما عندما تتغير حالة التنبيه من OK إلى TRIGGERED.
   • في كل مرة يتم فيها تقييم التنبيه: أرسل إشعارا كلما كانت حالة TRIGGERED التنبيه بغض النظر عن حالتها في التقييم السابق.
   • على الأكثر كل: إرسال إشعار كلما كانت حالة TRIGGERED التنبيه في فاصل زمني محدد. يتيح لك هذا الاختيار تجنب البريد العشوائي للإعلامات للتنبيهات التي يتم تشغيلها في كثير من الأحيان.

   بغض النظر عن إعداد الإعلام الذي تختاره، تتلقى إعلاما كلما انتقلت الحالة من OK أو TRIGGERED إلى TRIGGEREDOK. تؤثر إعدادات الجدولة على عدد الإعلامات التي ستتلقىها إذا بقيت TRIGGERED الحالة من تنفيذ إلى آخر. للحصول على التفاصيل، راجع تكرار الإعلام.

6. في القائمة المنسدلة قالب ، اختر قالبا:

   • استخدام القالب الافتراضي: إعلام التنبيه عبارة عن رسالة تحتوي على ارتباطات إلى شاشة تكوين التنبيه وشاشة الاستعلام.
   • استخدام قالب مخصص: يتضمن إعلام التنبيه معلومات أكثر تحديدا حول التنبيه.

     1. يتم عرض مربع، يتكون من حقول إدخال للموضوع والنص الأساسي. أي محتوى ثابت صالح، ويمكنك دمج متغيرات القالب المضمنة:

        • ALERT_STATUS: حالة التنبيه التي تم تقييمها (سلسلة).
        • ALERT_CONDITION: عامل تشغيل حالة التنبيه (سلسلة).
        • ALERT_THRESHOLD: حد التنبيه (سلسلة أو رقم).
        • ALERT_COLUMN: اسم عمود التنبيه (سلسلة).
        • ALERT_NAME: اسم التنبيه (سلسلة).
        • ALERT_URL: عنوان URL لصفحة التنبيه (سلسلة).
        • QUERY_NAME: اسم الاستعلام المقترن (سلسلة).
        • QUERY_URL: عنوان URL لصفحة الاستعلام المقترنة (سلسلة).
        • QUERY_RESULT_TABLE: جدول HTML لنتيجة الاستعلام (سلسلة).
        • QUERY_RESULT_VALUE: قيمة نتيجة الاستعلام (سلسلة أو رقم).
        • QUERY_RESULT_ROWS: صفوف نتائج الاستعلام (صفيف القيمة).
        • QUERY_RESULT_COLS: أعمدة نتيجة الاستعلام (صفيف السلسلة).

        مثال على الموضوع، على سبيل المثال، يمكن أن يكون: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.

     2. يمكنك استخدام HTML لتنسيق الرسائل في قالب مخصص. يسمح بالعلامات والسمات التالية في القوالب:

        • العلامات: <a>و <abbr>و و <b><acronym>و <blockquote>و<body><tr><th><em><td><h1><div><i><h2><li><h3><ol><table><html><tbody><strong><span><p><hr>><head>><h4><h6<br><code><h5.<ul>
        • السمات: href (ل <a>)، العنوان (ل <a>، ، <acronym><abbr>)

     3. انقر فوق زر تبديل المعاينة لمعاينة النتيجة المعروضة.

        هام

        المعاينة مفيدة للتحقق من تقديم متغيرات القالب بشكل صحيح. إنه ليس تمثيلا دقيقا لمحتوى الإعلام النهائي، حيث يمكن لكل وجهة إعلام عرض الإعلامات بشكل مختلف.

     4. انقر فوق الزر حفظ التغييرات.

7. انقر فوق إنشاء تنبيه.

8. انقر فوق إضافة جدول زمني.

   • استخدم منتقيات القائمة المنسدلة لتحديد التردد والفترة ووقت البدء والمنطقة الزمنية. اختياريا، حدد خانة الاختيار Show cron syntax لتحرير الجدول في بناء جملة Quartz Cron.
   • اختر المزيد من الخيارات لإظهار الإعدادات الاختيارية. يمكنك أيضا اختيار:
     • اسم للجدول الزمني.
     • مستودع SQL لتشغيل الاستعلام. بشكل افتراضي، يتم استخدام مستودع SQL المستخدم لتنفيذ الاستعلام المخصص أيضا لمهمة مجدولة. استخدم هذا الإعداد الاختياري لتحديد مستودع مختلف لتشغيل الاستعلام المجدول.

9. انقر فوق علامة التبويب الوجهات في مربع الحوار إضافة جدول زمني.

   

   • استخدم القائمة المنسدلة لتحديد وجهة إعلام متوفرة. أو ابدأ بكتابة اسم مستخدم لإضافة أفراد.

   هام

   إذا تخطيت هذه الخطوة، فلن يتم إعلامك عند تشغيل التنبيه.

10. انقر فوق Create. تظهر تفاصيل التنبيه والإعلام المحفوظة على الشاشة.

    

11. مشاركة الجدول الزمني.

    • على الجانب الأيسر من الجدول المدرج، اختر قائمة kebab وحدد Edit schedule permissions.
    • اختر مستخدما أو مجموعة من القائمة المنسدلة في مربع الحوار.
    • اختر من أذونات الجدولة التالية:
      • لا توجد أذونات: لم يتم منح أي أذونات. لا يمكن للمستخدمين الذين ليس لديهم أذونات رؤية وجود الجدول الزمني، حتى لو كانوا مشتركين أو مضمنين في وجهات الإعلام المدرجة.
      • CAN VIEW: منح الإذن لعرض نتائج التشغيل المجدولة.
      • CAN MANAGE RUN: منح الإذن لعرض نتائج التشغيل المجدولة.
      • CAN MANAGE: منح الإذن لعرض الجداول وتعديلها وحذفها. هذا الإذن مطلوب لإجراء تغييرات على الفاصل الزمني للتشغيل وتحديث قائمة المشتركين وإيقاف الجدول مؤقتا أو إلغاء تشغيله.
      • IS OWNER: يمنح جميع أذونات CAN MANAGE. بالإضافة إلى ذلك، سيتم استخدام بيانات اعتماد مالك الجدولة لتشغيل استعلامات لوحة المعلومات. يمكن فقط لمسؤول مساحة العمل تغيير المالك.

    هام

    أذونات التنبيهات والجدولات منفصلة. امنح حق الوصول إلى المستخدمين والمجموعات في قائمة وجهات الإعلامات حتى يتمكنوا من عرض نتائج التشغيل المجدولة.

12. مشاركة التنبيه.

    • انقر بالقرب من أعلى يمين الصفحة.
    • إضافة مستخدمين أو مجموعات يجب أن يكون لديهم حق الوصول إلى التنبيه.
    • اختر مستوى الأذونات المناسب، ثم انقر فوق إضافة.

هام

يمنح CAN MANAGE الإذن لعرض الجداول وتعديلها وحذفها. هذا الإذن مطلوب لإجراء تغييرات على الفاصل الزمني للتشغيل، وتحديث قائمة وجهة الإعلام، وإيقاف الجدول مؤقتا أو إلغاء تشغيله.

لمزيد من المعلومات حول مستويات أذونات التنبيه، راجع قوائم التحكم في الوصول إلى التنبيهات.

تجميعات التنبيه

يعمل التجميع على تنبيه عن طريق تعديل SQL الأصلي لاستعلام Databricks SQL المرفق بالتنبيه. يقوم التنبيه بتضمين نص الاستعلام الأصلي في تعبير جدول شائع (CTE) وينفذ استعلام تجميع التفاف عليه لتجميع نتيجة الاستعلام.

على سبيل المثال، SUM يعني التجميع على تنبيه مرفق باستعلام مع نص SELECT 1 AS column_name أنه كلما تم تحديث التنبيه، فإن SQL المعدل الذي يتم تشغيله سيكون: WITH q AS (SELECT 1 AS column_name) SELECT SUM(column_name) FROM q.

وهذا يعني أنه لا يمكن عرض نتيجة الاستعلام الأصلية (مجمعة مسبقا) في نص مخصص للتنبيه (مع معلمات مثل QUERY_RESULT_ROWS و QUERY_RESULT_COLS) كلما كان هناك تجميع على تنبيه. بدلا من ذلك، ستعرض هذه المتغيرات نتيجة استعلام ما بعد التجميع النهائية فقط.

إشعار

لا تدعم واجهة برمجة التطبيقات جميع شروط المشغل المتعلقة بالتجميعات.

تنبيه على أعمدة متعددة

لتعيين تنبيه استنادا إلى أعمدة متعددة للاستعلام، يمكن للاستعلام تنفيذ منطق التنبيه وإرجاع قيمة منطقية للتنبيه لتشغيله. على سبيل المثال:

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

يرجع 1 هذا الاستعلام عندما drafts_count > 10000 and archived_count > 5000. ثم يمكنك تكوين التنبيه لتشغيله عندما تكون 1القيمة .

تكرار الإعلام

يرسل Databricks SQL إعلامات إلى وجهات الإعلام التي اخترتها كلما اكتشف أن حالة التنبيه قد تغيرت من OK إلى TRIGGERED أو العكس. خذ بعين الاعتبار هذا المثال حيث يتم تكوين تنبيه على استعلام مجدول للتشغيل مرة واحدة يوميا. تظهر الحالة اليومية للتنبيه في الجدول التالي. قبل يوم الاثنين كانت OKحالة التنبيه .

‏‏يوم	حالة التنبيه
الاثنين	موافق
الثلاثاء	موافق
الأربعاء	تشغيل
الخميس	تشغيل
الجمعة	تشغيل
السبت	تشغيل
الأحد	موافق

إذا تم تعيين تكرار الإعلام إلى Just Once، يرسل Databricks SQL إعلاما يوم الأربعاء عندما تغيرت الحالة من OK إلى TRIGGERED ومرة أخرى يوم الأحد عند التبديل مرة أخرى. لا يرسل تنبيهات يوم الخميس أو الجمعة أو السبت إلا إذا قمت بتكوينه على وجه التحديد للقيام بذلك لأن حالة التنبيه لم تتغير بين عمليات التنفيذ في تلك الأيام.

تكوين أذونات التنبيه ونقل ملكية التنبيه

يجب أن يكون لديك على الأقل إذن CAN MANAGE على استعلام لمشاركة الاستعلامات. للحصول على مستويات أذونات التنبيه، راجع قوائم التحكم بالوصول للتنبيهات.

1. في الشريط الجانبي، انقر فوق تنبيهات.

2. انقر فوق تنبيه.

3. انقر فوق الزر الموجود في أعلى اليمين لفتح مربع الحوار مشاركة.

   

4. ابحث عن المجموعات والمستخدمين وحددها، وقم بتعيين مستوى الأذونات.

5. انقر فوق إضافة.

نقل ملكية تنبيه

عندما تحفظ تنبيها، تصبح مالك التنبيه. إذا تمت إزالة مالك التنبيه من مساحة عمل، فلن يكون للتنبيه مالك. يمكن لمستخدم مسؤول مساحة العمل نقل ملكية تنبيه إلى مستخدم مختلف. لا يمكن تعيين ملكية تنبيه لكيانات الخدمة ومجموعاتها. يمكنك أيضا نقل الملكية باستخدام واجهة برمجة تطبيقات الأذونات.

1. بصفتك مسؤول مساحة العمل، سجل الدخول إلى مساحة عمل Azure Databricks.

2. في الشريط الجانبي، انقر فوق تنبيهات.

3. انقر فوق تنبيه.

4. انقر فوق الزر مشاركة في أعلى اليمين لفتح مربع الحوار مشاركة.

5. انقر فوق أيقونة الترس في أعلى اليمين وانقر فوق تعيين مالك جديد.

   

6. حدد المستخدم الذي تريد تعيين الملكية إليه.

7. انقر فوق تأكيد.