Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Diese Seite führt Sie Schritt für Schritt durch die Erstellung einer Databricks SQL-Warnung von Anfang bis Ende. Es behandelt den Warnungs-Editor, das Lernprogramm zum Erstellen einer Warnung, das Überprüfen von Auswertungsdetails und die erweiterten Einstellungen und Benachrichtigungsvorlagen, die Sie konfigurieren können.
Erkunden Sie den Benachrichtigungseditor
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.
- Abfrageeditor: Schreiben und testen Sie die Abfrage, für die Sie eine Warnung einrichten möchten.
- Compute: Wählen Sie das SQL-Warehouse aus, das die Alarmabfrage ausführt. Die Statusanzeige zeigt an, ob das ausgewählte Lager in Betrieb ist. Empfehlungen zur Größe des SQL-Warehouse und zum Verhalten zur geplanten Ausführungszeit finden Sie unter Auswählen eines SQL-Warehouse für eine Warnung.
- Zeitplan: Legen Sie einen regelmäßigen Zeitplan für das Ausführen der Warnung fest.
- Freigeben: Legen Sie Berechtigungen fest, die festlegen, wie andere in Ihrem Arbeitsbereich mit Ihrer Warnung arbeiten können.
- Bedingung: Wählen Sie den Wertschwellenwert aus, der eine Benachrichtigung auslösen sollte. Sie können die Abfrage ausführen, um die Bedingung in diesem Abschnitt zu testen.
-
Benachrichtigungen: Geben Sie an, welche Benutzer oder Benachrichtigungsziele alarmiert werden sollten, wenn der Schwellenwert außerhalb des erwarteten Bereichs liegt. Legen Sie optional ein Benachrichtigungsintervall fest, damit Benachrichtigungen wiederholt werden, bis der Alarm wieder auf
OKwechselt. - Erweitert: Verwenden Sie erweiterte Einstellungen, um bei speziellen Werten und Bedingungen zu warnen.
Eine Warnung erstellen
Führen Sie die folgenden Schritte aus, um eine Warnung zu erstellen:
Klicken Sie in der Randleiste auf
Benachrichtigungen, und klicken Sie auf Alarm erstellen.Kopieren Sie die folgende Abfrage, und fügen Sie sie in den Abfrage-Editor ein. Klicken Sie auf Alle ausführen (1000). Um mehr über die Arbeit mit dem SQL-Editor zu erfahren, siehe Databricks 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 DESCKlicken Sie auf den Compute-Selektor, und klicken Sie dann in der Liste auf ein Warehouse, um anzugeben, auf welcher Compute-Ressource die Warnung ausgeführt wird.
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. Sie können eine Warnungsbedingung für den ersten Wert einer Spalte im Abfrageergebnis festlegen oder eine Aggregation für alle Zeilen einer einzelnen Spalte festlegen, z. B. SUMME oder MITTELWERT.
- 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 value4000 fest. Statischer Wert ist standardmäßig ausgewählt. Geben Sie 4000 in das Wertfeld ein.
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.
Suchen Sie im Abschnitt "Benachrichtigungen" nach Ihrem Benutzernamen, und klicken Sie darauf, wenn er angezeigt wird.
Klicken Sie auf das
, um das Dialogfeld "Zeitplan bearbeiten " zu öffnen. Verwenden Sie die Dropdownmenüs, um den Alarm so einzustellen, dass er Alle 5Minuten ab 0 Minuten nach der vollen Stunde läuft. Klicke auf Speichern. Optional können Sie das Kontrollkästchen Cron-Syntax anzeigen auswählen, um den Zeitplan in Quartz Cron Syntax zu bearbeiten.
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 ausgelöst. Sie erhalten eine E-Mail-Benachrichtigung als Warnung. Wenn die TestbedingungOK zurückgegeben hat, wird keine Benachrichtigung gesendet.
Benachrichtigungsdetails überprüfen
Eine Seite wird geöffnet, um Ihre Warnungsdetails anzuzeigen. Auf der Seite wird auch ein Warnungsverlauf mit Auswertungsdetails angezeigt. Klicken Sie auf die Schaltfläche "Jetzt ausführen", um die Warnungsabfrage sofort auszuführen und das Ergebnis auf dieser Seite zurückzugeben.
Klicken Sie in der oberen rechten Ecke der Seite auf "Bearbeiten ", um die Bearbeitung der Benachrichtigung fortzusetzen.
Untersuchen Sie eine Warnung mit Genie-Code
Important
Dieses Feature befindet sich in der Betaversion. Um sie zu verwenden, muss ein Arbeitsbereichsadministrator die Vorschau für Alertv2 Genie Analysis aktivieren. Siehe Genie-Code-Analyse konfigurieren.
Nachdem Sie die Genie-Code-Analyse für eine Warnung konfiguriert haben, beginnt die Analyse, wenn sich die Warnung von einem anderen Zustand in Triggered oder Error ändert. Siehe Genie-Code-Analyse konfigurieren. Eine Bewertung, die im gleichen Zustand bleibt, startet keine weitere Analyse. Wenn der Start der Analyse fehlschlägt oder länger als 60 Sekunden dauert, werden die Alarmbewertung und Benachrichtigungen ohne Untersuchungslink fortgesetzt.
Nachdem die Analyse abgeschlossen ist, klicken Sie auf Untersuchen für die Bewertung in Verlauf. Sie können auch die Bewertungsdetails öffnen und auf Investigate klicken. Beide Links öffnen dieselbe Genie-Code-Untersuchung.
Unterstützte Standard-Benachrichtigungsvorlagen können auch einen Link zur Untersuchung enthalten. Diese Vorlagen umfassen E-Mail, Microsoft Teams, PagerDuty, Slack Block Kit und Standard-Webhooks. Legacy Slack-Anhänge und benutzerdefinierte Webhook-Vorlagen enthalten den Link nicht.
Der Benutzer, mit dessen Anmeldedaten die Warnung ausgeführt wird, besitzt den generierten Genie Code-Thread. Ein Untersuchungslink gewährt keinen Zugriff, und Benachrichtigungsberechtigungen sowie Thread-Berechtigungen sind getrennt. Siehe Benachrichtigungsberechtigungen konfigurieren und Benachrichtigungsbesitz übertragen. Der Thread-Eigentümer muss den Chat-Thread erst mit den Empfängern teilen, bevor sie ihn öffnen können. Generierte Untersuchungen sind schreibgeschützt. Um die Untersuchung in einer bearbeitbaren Kopie fortzusetzen, klicken Sie auf Clone to continue.
Aktive Ausführungslimits im Arbeitsbereich
Warnungsausführungen unterliegen einem aktiven Ausführungslimit auf Arbeitsbereichsebene. Jeder Arbeitsbereich hat einen Standardgrenzwert von 250 gleichzeitig aktiven Warnungen. Wenn alle Ausführungsslots belegt sind und eine geplante Warnung ausgelöst wird, wird die Warnungsausführung übersprungen und die Warnung wird nicht ausgewertet.
Wenn Sie vermuten, dass Warnungen übersprungen werden, überprüfen Sie den Auswertungsverlauf auf Lücken zur geplanten Zeit. Das am häufigsten verwendete Muster besteht darin, dass alle betroffenen Warnungen den gleichen Zeitplan verwenden und eine manuelle Ausführung jetzt erfolgreich ist, da sie außerhalb der Parallelitätsspitzen ausgeführt wird.
Vermeiden des Erreichens des Grenzwerts aktiver Ausführungen
Um die gleichzeitige Nachfrage nach Ausführungsslots zu reduzieren, staffeln Sie Warnungszeitpläne so, dass sie nicht alle zur selben Zeit ausgelöst werden. Zum Beispiel: Statt alle Warnungen für 01:30 einzuplanen, planen Sie sie für 01:30, 01:32, 01:34 usw. ein.
Anfordern einer Kontingenterhöhung
Wenn Ihr Arbeitsbereich konsistent den Grenzwert für die aktive Ausführung erreicht, wenden Sie sich an den Databricks-Support , um eine Erhöhung des maximal aktiven Ausführungskontingents Ihres Arbeitsbereichs anzufordern. Geben Sie die Arbeitsbereichs-ID, das ungefähre Zeitfenster für das Überspringen von Ausführungen und die Gesamtzahl der betroffenen Warnungen an.
Erweiterte Einstellungen
Klicken Sie auf "Erweiterte Einstellungen" , um die folgenden Einstellungen anzuwenden:
-
Benachrichtigen auf OK: Senden Sie eine Benachrichtigung, wenn die Warnung als
OKzurückkehrt. - Leerer Ergebniszustand: Legen Sie einen speziellen Status fest, der zurückgegeben wird, wenn die Abfrage keine Ergebnisse zurückgibt.
- Vorlage: Konfigurieren Sie die Benachrichtigungsvorlage. Siehe Benachrichtigungsvorlagen.
Arbeitsbereichsadministratoren können neue Benachrichtigungsziele einrichten. Weitere Informationen finden Sie unter Verwalten von Benachrichtigungszielen.
Für den JSON-Körper, den eine Warnung an ein Webhook-Benachrichtigungsziel sendet, siehe SQL Alert Webhook Payload.
Genie-Code-Analyse konfigurieren
Important
Dieses Feature befindet sich in der Betaversion. Um sie zu verwenden, muss ein Workspace-Administrator die Alertv2 Genie-Analyse auf der Seite Previews aktivieren. Siehe Manage Azure Databricks Previews.
Ein Workspace-Administrator muss die Vorschau der Alertv2 Genie Analysis aktivieren, bevor Benachrichtigungsbesitzer die Funktion konfigurieren können:
- Klicken Sie als Workspace-Administrator auf Ihren Benutzernamen in der oberen Leiste des Azure Databricks-Arbeitsbereichs und wählen Sie Vorschauen aus.
- Aktivieren Sie Alertv2 Genie Analysis.
Siehe Verwalten von Vorschauen auf Arbeitsbereichsebene.
Um die Genie-Code-Analyse im Alarmeditor zu konfigurieren:
- Klicken Sie auf Erweiterte Einstellungen.
- Wählen Sie Genie-Code-Analyse bei Alarmauslösung ausführen aus.
- Geben Sie optional benutzerdefinierte Anweisungen für die Untersuchung ein. Benutzerdefinierte Anweisungen ersetzen die generische Analyseanweisung.
- Klicken Sie auf Warnung anzeigen, um die Warnung zu speichern.
Die Warnung ist so konfiguriert, dass eine neue Untersuchung gestartet wird, sobald sich ihr Zustand auf Ausgelöst oder Fehler ändert.
Die Analyse gilt nur für Warnungen, die als Benutzer ausgeführt werden. Warnungen, die als Service-Principal ausgeführt werden, starten keine Analyse. Siehe Untersuchen Sie eine Warnung mit Genie Code.
Benachrichtigungsvorlagen
Benachrichtigungen verwenden die Standardvorlage, es sei denn, Sie passen sie an. Um den Betreff und den Text anzupassen, wählen Sie "Vorlage anpassen" aus. Zwei Editoren sind verfügbar: der Standard-Editor und der Markdown-Editor. Klicken Sie unten auf die Registerkarten, um sie zu vergleichen.
Standardeditor
Verweisen Sie im Standard-Editor im Betreff und Textkörper mit {{VARIABLE_NAME}} auf Referenzvariablen. Die folgenden Variablen werden unterstützt:
-
ALERT_STATUS: Der ausgewertete Alarmstatus (Zeichenfolge). -
ALERT_CONDITION: Der Alarmzustandsoperator (Zeichenfolge). -
ALERT_THRESHOLD: Die Alarmschwelle (Zeichenfolge oder Zahl). -
ALERT_COLUMN: Der Spaltenname der Alert-Spalte (Zeichenkette). -
ALERT_NAME: Der Alarmname (Zeichenfolge). -
ALERT_URL: Die URL der Alarmseite (Zeichenkette). -
QUERY_RESULT_TABLE: Die HTML-Tabelle (Zeichenkette) der Abfrageergebnisse. 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 (String-Array).
Beispiel: Alert "{{ALERT_NAME}}" changed status to {{ALERT_STATUS}}.
Der Standard-Editor unterstützt auch HTML für die Formatierung. Nur E-Mail-Benachrichtigungsziele können HTML rendern. Die folgenden HTML-Tags sind zulässig: <a>, <b>, <blockquote>, <br>, <code>, <del>, <div>, <em>, <h1>, <h2>, <h3>, <h4>, <h5>, <h6>, <hr>, <i>, <img>, <li>, <ol>, <p>, <pre>, <span>, <table>, <thead>, <tbody>, <td>, <th>, <tr>, <u>, <ul>.
Die folgenden Attribute sind für die aufgelisteten Tags zulässig:
| Attribut | Unterstützte Tags |
|---|---|
href |
<a> |
title |
<img> |
target |
<a> |
alt |
<img> |
src |
<img> |
start |
<b>, <blockquote>, <code>, <del>, <em>, <hr>, <i>, <pre>, <u> |
Klicken Sie auf die Umschaltfläche Vorschau, um eine Vorschau des gerenderten Ergebnisses anzuzeigen.
Important
Die Vorschau ist nützlich, um sicherzustellen, dass die Vorlagenvariablen korrekt gerendert werden. Es handelt sich nicht um eine genaue Darstellung des eventuellen Benachrichtigungsinhalts, da jedes Benachrichtigungsziel Benachrichtigungen anders anzeigen kann.
Markdown-Editor
Aktivieren Sie den Markdown-Editor , um den Textkörper mithilfe von Markdown zu schreiben. Der Markdown-Editor verfügt über eine Formatierungssymbolleiste und eine gerenderte Vorschau.
Verweisen Sie im Markdown-Editor auf Variablen mit @VARIABLE_NAME. Geben Sie im Text @ ein, um die Variablenauswahl zu öffnen. Der Markdown-Editor unterstützt ALERT_NAME, , ALERT_STATUS, ALERT_CONDITIONALERT_THRESHOLD, , ALERT_COLUMN, und ALERT_URLQUERY_RESULT_TABLE.