SQL-Warnungen für Databricks

Wichtig

Dieses Feature befindet sich in der Public Preview.

Diese Seite enthält schrittweise Anleitungen zum Aktivieren und Verwenden von Databricks SQL-Warnungen zum Automatisieren der Abfrageausführung, zum Auswerten von benutzerdefinierten Bedingungen und zum Übermitteln von Benachrichtigungen, wenn diese Bedingungen erfüllt sind. Mit Warnungen können Sie Ihre Geschäftsdaten proaktiv überwachen und zeitnah Benachrichtigungen empfangen, wenn gemeldete Werte außerhalb der erwarteten Schwellenwerte liegen. Wenn Sie eine Warnung planen, wird die zugehörige Abfrage ausgeführt, und die Warnungskriterien werden unabhängig von vorhandenen Zeitplänen in der zugrunde liegenden Abfrage überprüft. Darüber hinaus können Sie auf einen Warnungsverlauf zugreifen, um die Ergebnisse früherer Warnungsbewertungen zu überprüfen.

Informationen zur Vorgehensweise bei älteren Warnmeldungen finden Sie unter Was sind Legacy- Warnungen?.

Aktivieren von Warnungen in Ihrem Arbeitsbereich

Arbeitsbereichsadministratoren können den Arbeitsbereichzugriff auf diese Vorschau über die Vorschauseite steuern. Das Aktivieren dieser Vorschau wirkt sich nicht auf Ihre vorhandenen Warnungen aus. Sie können diese und ältere Warnungen weiterhin parallel verwenden.

Anzeigen und Strukturieren von Warnungen

Klicken Sie auf das in der Randleiste, um die Warnungsübersichtsseite zu öffnen.

• Die Registerkarte " Warnungen " ist standardmäßig geöffnet und zeigt alle Warnungen im Arbeitsbereich an. Sie können eingeben, um nach Namen zu filtern. Klicken Sie auf "Nur meine Benachrichtigungen ", um nur Warnungen anzuzeigen, bei denen Sie der Besitzer sind.

• Auf der Registerkarte "Legacy-Warnungen " werden Warnungen angezeigt, die mit dem vorherigen Warnungssystem erstellt wurden.

• Name enthält die Namenszeichenfolge der jeweiligen Warnung.

• Der Status zeigt an, ob der Warnungsstatus TRIGGERED, , OKoder ERROR.

• Der Zeitplan zeigt die uhrzeit oder das Datum der letzten Aktualisierung an.

• Eigentümer zeigt den Benutzernamen der Person an, die für die Benachrichtigung verantwortlich ist.

• Erstellt unter zeigt das Datum und die Uhrzeit an, wann die Warnung erstellt wurde.

  • TRIGGERED bedeutet, dass bei der letzten Ausführung die Spalte "Wert " in Ihrer Zielabfrage die von Ihnen konfigurierte Bedingung und den von Ihnen konfigurierten Schwellenwert erfüllt hat. Wenn Ihre Warnung überprüft, dass "Katzen" einen Wert über 1500 hat, wird sie ausgelöst, solange der Wert über 1500 bleibt.
  • OK bedeutet, dass die Spalte "Wert " bei der letzten Abfrageausführung die von Ihnen konfigurierte Bedingung und den von Ihnen konfigurierten Schwellenwert nicht erfüllt hat. Dies bedeutet nicht, dass die Warnung zuvor nicht ausgelöst wurde. Wenn Ihr Wert "Katzen" jetzt 1470 ist, wird Ihre Warnung als OKangezeigt.
  • ERROR gibt an, dass während der Warnungsauswertung ein Fehler aufgetreten ist.

Erstellen einer Warnung

Die Schritte in diesem Abschnitt führen Sie durch das Erstellen der Warnung, die in der folgenden Abbildung gezeigt wird. Verwenden Sie die Bezeichnungen und Erläuterungen, um die einzelnen Komponenten zu verstehen.

1. Abfrage-Editor: Schreiben und testen Sie die Abfrage, für die Sie benachrichtigen möchten.

2. Zeitplan: Legen Sie einen regelmäßigen Zeitplan für die Ausführung der Warnung fest.

3. Zustand: Wählen Sie den Wertschwellenwert aus, der eine Warnungsbenachrichtigung auslösen soll. Sie können die Abfrage ausführen, um die Bedingung in diesem Abschnitt zu testen.

4. Benachrichtigungen: Geben Sie an, welche Benutzer oder Benachrichtigungsziele benachrichtigt werden sollen, wenn der Schwellenwert außerhalb des erwarteten Bereichs liegt.

5. Fortgeschritten: Verwenden Sie erweiterte Einstellungen, um bei speziellen Werten und Bedingungen zu benachrichtigen.

Wichtig

Während der Phase der "Öffentlichen Vorschau" unterstützen Warnungen keine Abfragen mit Parametern. Siehe Was sind Legacy-Warnungen?.

Führen Sie die folgenden Schritte aus, um eine Warnung zu erstellen:

1. Klicken Sie in der Randleiste auf Benachrichtigungen, und klicken Sie auf Alarm erstellen.

2. Kopieren Sie die folgende Abfrage, und fügen Sie sie in den Abfrage-Editor ein. Klicken Sie auf Alle ausführen (1000). Weitere Informationen zum Arbeiten mit dem SQL-Editor finden Sie unter Schreiben von Abfragen und Untersuchen von Daten im neuen SQL-Editor.

   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. Legen Sie im Feld "Bedingung " die Bedingungen fest, die die Warnung auslösen sollen.

   

   Wenden Sie die folgenden Einstellungen wie gezeigt an:

   • Wählen Sie "Summe " als zu überprüfenden Datenwert aus. Warnungsbedingungen können für den ersten Wert einer Spalte im Abfrageergebnis festgelegt werden. Sie können auch eine Aggregation über alle Zeilen einer einzelnen Spalte festlegen, z. B. SUM oder AVERAGE.
   • Wählen Sie den Betrag als zu überprüfende Spalte aus.
   • Wählen Sie > (größer als) als logischer Operator aus, der angewendet werden soll.
   • Legen Sie den Schwellenwert auf Static value 4000 fest. Statischer Wert ist standardmäßig ausgewählt. Geben Sie 4000 in das Wertfeld ein.

4. Klicken Sie auf "Bedingung testen ", um eine Vorschau der Warnung anzuzeigen und zu testen, ob die Warnung mit den aktuellen Daten ausgelöst würde. Die bereitgestellten Einstellungen sollten die Warnung auslösen. Sie können den Schwellenwert so ändern, dass er weiter getestet wird.

5. Suchen Sie im Abschnitt "Benachrichtigungen" nach Ihrem Benutzernamen, und klicken Sie darauf, wenn er angezeigt wird.

6. Klicken Sie auf das , um das Dialogfeld "Zeitplan bearbeiten " zu öffnen. Verwenden Sie die Dropdownmenüs, um die Warnung so festzulegen, dass sie alle 5Minuten von 0 Minuten nach der Stunde ausgeführt wird. Klicken Sie auf "Speichern". Optional können Sie das Kontrollkästchen Cron-Syntax anzeigen auswählen, um den Zeitplan in Quartz Cron Syntax zu bearbeiten.

7. Klicken Sie auf " Warnung anzeigen".

Ihre Warnung wird gespeichert und wird im von Ihnen bereitgestellten Zeitplan ausgeführt. Die in diesem Beispiel verwendeten Daten sind statisch. Wenn die Testbedingung also als ausgelöst zurückgegeben wird, wird sie bei der nächsten Ausführung erneut ausgeführt. Sie erhalten eine E-Mail-Benachrichtigung als Warnung. Wenn die TestbedingungOK zurückgegeben hat, wird keine Benachrichtigung gesendet.

Warnungsdetails überprüfen

Eine Seite wird geöffnet, um Ihre Warnungsdetails anzuzeigen. Darüber hinaus wird ein Warnungsverlauf mit Auswertungsverlaufsdetails angezeigt. Klicken Sie auf die Schaltfläche " Jetzt ausführen", um die Warnungsabfrage sofort auszuführen und das Ergebnis auf diesem Bildschirm zurückzugeben.

Klicken Sie in der oberen rechten Ecke der Seite auf "Bearbeiten ", um die Bearbeitung der Benachrichtigung fortzusetzen.

Erweiterte Einstellungen

Klicken Sie auf "Erweiterte Einstellungen" , um die folgenden Einstellungen anzuwenden:

• Benachrichtigen Sie bei "OK": Senden Sie eine Benachrichtigung, wenn die Warnung als OK zurückkehrt.

• Häufigkeit der Benachrichtigung: Regelmäßig Benachrichtigungen über eine Warnung senden, bis der Status wieder xxxOK ist.

• Leerer Ergebnisstatus: Legen Sie einen speziellen Status fest, der zurückgegeben werden soll, wenn die Abfrage keine Ergebnisse zurückgibt.

• Schablone: Sie können Benachrichtigungen mithilfe der Standardvorlage oder einer benutzerdefinierten Vorlage senden. In der folgenden Liste werden die einzelnen Vorlagentypen erläutert:

  • Standardvorlage verwenden: Warnungsbenachrichtigung ist eine Meldung mit Links zu den Bildschirmen „Warnungskonfiguration“ und „Abfrage“.

  • Benutzerdefinierte Vorlage verwenden: Die Warnungsbenachrichtigung enthält spezifischere Informationen zur Warnung.

    1. Ein Feld mit Eingabefeldern für Betreff und Text wird angezeigt. Jeder statische Inhalt ist gültig, und Sie können integrierte Vorlagenvariablen verwenden:

       • ALERT_STATUS: Der ausgewertete Warnungsstatus (Zeichenfolge).
       • ALERT_CONDITION: Der Bedingungsoperator der Warnung (Zeichenfolge).
       • ALERT_THRESHOLD: Der Warnungsschwellenwert (Zeichenfolge oder Zahl).
       • ALERT_COLUMN: Der Name der Warnungsspalte (Zeichenfolge).
       • ALERT_NAME: Der Warnungsname (Zeichenfolge).
       • ALERT_URL: Die URL der Warnungsseite (Zeichenfolge).
       • QUERY_RESULT_TABLE: Die HTML-Tabelle mit dem Abfrageergebnis (Zeichenfolge). Die Ergebnisse sind auf die ersten 100 Zeilen beschränkt. Nur E-Mail-Benachrichtigungsziele können HTML rendern.
       • QUERY_RESULT_VALUE: Der Abfrageergebniswert (Zeichenfolge oder Zahl).
       • QUERY_RESULT_ROWS: Die Abfrageergebniszeilen (Wertarray).
       • QUERY_RESULT_COLS: Die Abfrageergebnisspalten (Zeichenfolgenarray).

       Beispiel für den Betreff: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.

    2. Sie können HTML verwenden, um Nachrichten in einer benutzerdefinierten Vorlage zu formatieren. Nur E-Mail-Benachrichtigungsziele können HTML rendern. Die folgenden Tags und Attribute sind in Vorlagen zulässig:

       • Zulässige Tags: <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>

       • Zulässige Attribute:

         Attribut	Unterstützte Tags
         href	<a>
         title	<img>
         target	<a>
         alt	<img>
         src	<img>
         start	<b>, <blockquote>, <code><del>, <em>, <hr>, <i>, <pre><u>

    3. Klicken Sie auf die Umschaltfläche Vorschau, um eine Vorschau des gerenderten Ergebnisses anzuzeigen.

       Wichtig

       Die Vorschau ist nützlich, um sicherzustellen, dass die Vorlagenvariablen korrekt gerendert werden. Es handelt sich nicht um eine genaue Darstellung des tatsächlichen Inhalts der Benachrichtigung, da jedes Benachrichtigungsziel die Benachrichtigungen anders anzeigen kann.

Arbeitsbereichsadministratoren können neue Benachrichtigungsziele einrichten. Weitere Informationen finden Sie unter Verwalten von Benachrichtigungszielen.

Warnungsaggregationen

Eine Aggregation für eine Warnung erfolgt durch Ändern des ursprünglichen SQL-Abfrage der an die Warnung angefügten Databricks SQL-Abfrage. Die Warnung umschließt den ursprünglichen Abfragetext mit einem gemeinsamen Tabellenausdruck (Common Table Expression, CTE) und führt eine Umbruch-Aggregationsabfrage darauf aus, um das Abfrageergebnis zu aggregieren.

Ein Beispiel: Eine SUM-Aggregation in einer Warnung, die an eine Abfrage mit dem Text SELECT 1 AS column_name angehängt ist, bedeutet, dass jedes Mal, wenn die Warnung aktualisiert wird, die geänderte SQL-Abfrage ausgeführt wird: WITH q AS (SELECT 1 AS column_name) SELECT SUM(column_name) FROM q.

Das bedeutet, dass das ursprüngliche Abfrageergebnis (voraggregiert) nicht in einem benutzerdefinierten Warnungstext (mit Parametern wie QUERY_RESULT_ROWS und QUERY_RESULT_COLS) angezeigt werden kann, wenn eine Aggregation für eine Warnung erfolgt. Stattdessen zeigen diese Variablen nur das endgültige Abfrageergebnis nach der Aggregation an.

Hinweis

Sämtliche Auslösebedingungen, die sich auf Aggregationen beziehen, werden von der API nicht unterstützt.

Warnung für mehrere Spalten

Um eine Warnung basierend auf mehreren Spalten einer Abfrage festzulegen, kann Ihre Abfrage die Warnungslogik implementieren und einen booleschen Wert zurückgeben, für den die Warnung ausgelöst werden soll. Zum Beispiel:

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

Diese Abfrage gibt bei 1drafts_count > 10000 and archived_count > 5000 zurück. Anschließend können Sie die Warnung so konfigurieren, dass sie ausgelöst wird, wenn der Wert 1 ist.

Warnung bei Metrik-Ansichten

Da Metrikansichten so konzipiert sind, dass sie wichtige Geschäftsmetriken nachverfolgen und messen, koppeln sie sich gut mit Warnungen, sodass Sie automatisch benachrichtigt werden können, wenn eine Metrik außerhalb eines erwarteten Bereichs fällt. Warnungen für Metrikansichten funktionieren auf die gleiche Weise wie eine Warnung für alle anderen Datasets. Wenn Sie die Abfrage zum Konfigurieren der Abfrage schreiben, verwenden Sie den vollqualifizierten Namen der Metrikansicht, die Sie überwachen möchten.

Funktionsweise der Git-Integration mit Warnungen

Sie können Git-Ordner von Databricks verwenden, um Änderungen an Warnungen nachzuverfolgen und zu verwalten. Um Benachrichtigungen mit Git nachzuverfolgen, platzieren Sie sie in einem Git-Ordner "Databricks". Neu geklonte Warnungen werden nur auf der Seite oder API für Warnungen angezeigt, nachdem ein Benutzer mit ihnen interagiert hat. Sie haben unterbrochene Zeitpläne, die von Nutzern ausdrücklich fortgesetzt werden müssen.

Git-Ordner für Databricks bieten eine zentrale Möglichkeit, allgemeine Git-Vorgänge für Warnungen und andere Arbeitsbereichsobjekte zu verwalten. Weitere Informationen finden Sie unter Azure Databricks Git-Ordner.

Unterschiede zwischen älteren Warnungen

Die neueste Version von Databricks SQL-Warnungen verhält sich anders als ältere Warnungen auf verschiedene Arten:

• Integration von Jobs: Die neueste Version unterstützt noch keine direkte Referenzierung eines Alarms in der Job-Pipeline. Dieses Feature wird in Kürze verfügbar sein. Ältere Warnungen unterstützen den Aufgabentyp "Alarm" in Jobs.
• Wiederverwendung von Abfragen: Eine vorhandene gespeicherte SQL-Abfrage kann beim Erstellen einer Warnung nicht wiederverwendet werden. Jede Warnung besitzt ihre Abfragedefinition, die direkt im neuen Warnungs-Editor erstellt werden kann.
• de-DE: Alarmstatuswerte: Alarmzustände sind vereinfacht, und Alarme unterstützen den UNKNOWN Status aus älteren Alarmsystemen nicht mehr. Auswertungen lösen sich zu OK, oder TRIGGEREDERROR.

Sie können während des Übergangs weiterhin sowohl die neuesten Warnungen als auch ältere Warnungen parallel verwenden.

Konfigurieren von Warnungsberechtigungen und Übertragen des Besitzes von Warnungen

Informationen zu Warnungsberechtigungsebenen finden Sie unter Warnungs-ACLs.

1. Wählen Sie Warnungen auf der Randleiste aus.

2. Klicke auf eine Warnung.

3. Klicken Sie in der oberen rechten Ecke der Benachrichtigungsdetailseite auf " Freigeben ", um das Dialogfeld " Freigabe " zu öffnen.

   

4. Suchen und wählen Sie die Gruppen oder Benutzer aus, und weisen Sie die Berechtigungsebene zu.

5. Klicken Sie auf Hinzufügen.

Übertragen des Besitzes einer Warnung

Wenn Sie eine Benachrichtigung speichern, werden Sie der Besitzer der Warnung. Wenn der Besitzer einer Warnung aus einem Arbeitsbereich entfernt wird, verfügt die Warnung nicht mehr über einen Besitzer. Arbeitsbereichs-Administratorbenutzer*innen können den Besitz einer Warnung an andere Benutzer*innen übertragen. Sie können den Besitz auch über die Berechtigungs-API übertragen.

1. Melden Sie sich als Arbeitsbereichsadministrator bei Ihrem Azure Databricks-Arbeitsbereich an.

2. Wählen Sie Warnungen auf der Randleiste aus.

3. Klicke auf eine Warnung.

4. Wählen Sie rechts oben die Schaltfläche Freigeben aus, um das Dialogfeld Freigeben zu öffnen.

5. Klicken Sie oben rechts auf das Zahnradsymbol, und klicken Sie dann auf Assign new owner (Neuen Besitzer zuweisen).

   

6. Wählen Sie den Benutzer oder die Benutzerin aus, dem bzw. der der Besitz zugewiesen werden soll.

7. Klicken Sie auf Bestätigen.