ジョブのSQLアラートタスク
SQL アラート タスクを使用して、ジョブの一部として Databricks SQL アラートを評価します。SQL アラート タスクを使用すると、アラートベースのモニタリングをデータパイプラインに統合し、他のジョブ タスクとともに、自動化された条件チェックと通知を有効にできます。Databricks SQL アラートの詳細については、「Databricks SQL アラート」を参照してください。
要件
SQLアラートタスクを使用するには、次の前提条件を満たす必要があります。
- ワークスペースに既存のDatabricks SQLアラートが必要です。アラートを作成するには、アラートを作成するを参照してください。
- 使用したいアラートに対して、少なくともCAN RUN権限が必要です。
- サーバレスまたはPro SQLウェアハウスにアクセスできる必要があります。
SQLアラートタスクを構成します
ジョブUIは、その他の構成設定に基づいてオプションを動的に表示します。SQL Alertタスクを構成するには:
-
ワークスペースで、サイドバーの
ジョブ & パイプライン をクリックします。
-
作成 をクリックし、 ジョブ をクリックします。
-
「別のタスクの種類を追加」をクリックします。 SQLアラート を検索し、タイルをクリックして選択します。
-
**タスク名**を入力してください。
-
アラート ドロップダウンメニューで、評価するDatabricks SQLアラートを選択します。
-
(オプション) SQLウェアハウス ドロップダウンメニューで、アラートクエリの実行に使用するSQLウェアハウスを選択します。設定されていない場合、アラートの内部ウェアハウスが使用されます。SQLアラートタスクには、サーバレスまたはPro SQLウェアハウスを使用する必要があります。
-
(任意)「**サブスクライバー**」ドロップダウンで、アラートの結果を含む通知を受け取るユーザーおよび通知先を選択します。設定されていない場合、アラートの内部サブスクライバー(該当する場合)が通知を受け取ります。クエリ結果を含め、通知の件名と本文をカスタマイズするには、基になるDatabricks SQLアラートで通知テンプレートを設定します。通知テンプレートを参照してください。
-
(オプション)この**タスク**の**実行**開始時、完了時、または失敗時にEメールアドレスまたはWebhookに通知するには、**通知**を使用します。
[ 追加 ] をクリックして、[ タスク通知 ] ダイアログを開きます。
- 通知の追加 をクリックして、新しい通知を追加するか、既存の通知を編集します。
- Destination ドロップダウン メニューから、送信先を選択します。必要な送信先が利用できず、適切な権限がある場合は、
新しいシステムの送信先を追加 をクリックして新しい送信先を設定します。システムの送信先を追加するには、ワークスペース管理者である必要があります。通知先を管理するを参照してください。
- **保存**をクリックして、設定を適用します。
-
(オプション) 継続時間のしきい値 または 再試行 を設定するには、高度なタスク設定を参照してください。
-
タスクの保存 をクリックします。
このタスクを編集、複製、無効化、または削除するには、「Lakeflowジョブでタスクを構成および編集する」を参照してください。
SQLアラートタスクの動作
ジョブがSQLアラートタスクを実行すると、以下が発生します。
- アラートのクエリは、指定された SQLウェアハウスで実行されます。
- アラート条件は、クエリ結果に対して評価されます。
- タスクで設定されたサブスクライバーは、アラートの結果に基づいて通知を受け取ります。
SQLアラートタスクは、以下のいずれかのステータスを報告します:
- 成功 :アラート条件がトリガーされたかどうかにかかわらず、アラートは正常に評価されました。
- 失敗: SQLウェアハウスの接続の問題やクエリーエラーなど、アラートの評価中にエラーが発生しました。
SQLアラートタスクは、アラート自体に設定されたスケジュールとは独立してアラートを評価します。基になるアラートのスケジュールは、ジョブの実行によって影響されません。
制限事項:
- SQLアラートタスクはパラメーターをサポートしていません。パラメーター化されたクエリを使用する必要がある場合は、代わりにSQLタスクの使用をご検討ください。
- SQLアラートタスクは、Databricks SQLアラートのみをサポートしています。レガシーアラートはサポートされていません。