ジョブ向け SQL アラートタスク

SQL アラート タスクを使用して、Databricks SQL アラートをジョブの一部として評価します。 SQL アラート タスクを使用すると、アラートベースの監視をデータ パイプラインに統合し、他のジョブ タスクと共に自動条件チェックと通知を有効にできます。 Databricks SQL アラートの詳細については、 Databricks SQL アラートに関するページを参照してください。

要件

SQL アラート タスクを使用するには、次の前提条件を満たす必要があります。

  • ワークスペースに既存の Databricks SQL アラートが必要です。 アラートを作成するには、「アラート の作成」を参照してください。
  • 使用するアラートに対して、少なくとも CAN RUN アクセス許可が必要です。
  • サーバーレスまたはプロの SQL ウェアハウスにアクセスできる必要があります。

SQL アラート タスクを構成する

ジョブ UI には、その他の構成済みの設定に基づいてオプションが動的に表示されます。 SQL Alert タスクを構成するには:

  1. ワークスペースで、[ワークフロー] アイコンをクリックします。サイドバーのジョブとパイプライン。
  2. [ 作成]、[ ジョブ] の順にクリックします。
  3. [ 別のタスクの種類の追加] をクリックします。 SQL アラートを検索し、タイルをクリックして選択します。
  4. タスク名を入力します。
  5. [ アラート ] ドロップダウン メニューで、評価する Databricks SQL アラートを選択します。
  6. (省略可能) [SQL Warehouse ] ドロップダウン メニューで、アラート クエリの実行に使用する SQL ウェアハウスを選択します。 設定されていない場合は、アラートの内部ストレージが使用されます。 SQL アラート タスクには、サーバーレスまたはプロの SQL ウェアハウスを使用する必要があります。
  7. (省略可能)[ サブスクライバー ] ドロップダウンで、アラートの結果を含む通知を受信するユーザーと通知先を選択します。 設定されていない場合、アラートの内部サブスクライバー (該当する場合) は通知を受け取ります。 クエリ結果を含む通知の件名と本文をカスタマイズするには、基になる Databricks SQL アラートで通知テンプレートを構成します。 通知テンプレートを参照してください。
  8. (省略可能) 通知を 使用して、このタスクの実行が開始、完了、または失敗したときに電子メール アドレスまたは Webhook に通知します。
    1. プラス アイコン の追加をクリックして、タスク通知ダイアログを開きます。
    2. [ 通知の追加] をクリックして新しい通知を追加するか、既存の通知を編集します。
    3. [ 宛先 ] ドロップダウン メニューから、宛先を選択します。 目的の宛先が使用できない場合、適切なアクセス許可がある場合は、[プラス] アイコンをクリックします。新しいシステム変換先を追加して、新しいものを設定します。 システムの宛先を追加するには、ワークスペース管理者である必要があります。 通知 先の管理を参照してください。
    4. 保存をクリックして設定を適用してください。
  9. (省略可能) 期間のしきい値 または 再試行を構成するには、「 タスクの詳細設定」を参照してください。
  10. [タスクの保存] をクリックします。

このタスクを編集、複製、無効化、または削除するには、「 Lakeflow ジョブのタスクの構成と編集」を参照してください。

SQL アラート タスクの動作

ジョブが SQL アラート タスクを実行すると、次の処理が行われます。

  1. アラートのクエリは、指定された SQL ウェアハウスで実行されます。
  2. アラート条件は、クエリ結果に対して評価されます。
  3. タスクで構成されたサブスクライバーは、アラートの結果に基づいて通知を受け取ります。

SQL アラート タスクは、次のいずれかの状態を報告します。

  • 成功: アラート条件がトリガーされたかどうかに関係なく、アラートは正常に評価されました。
  • 失敗: SQL ウェアハウスの接続の問題やクエリ エラーなど、アラートの評価中にエラーが発生しました。

Note

SQL アラート タスクは、アラート自体に構成されているスケジュールとは別にアラートを評価します。 基になるアラートのスケジュールは、ジョブの実行の影響を受けません。

Limitations

  • SQL アラート タスクでは、パラメーターはサポートされていません。 パラメーター化クエリを使用する必要がある場合は、代わりに SQL タスク を使用することを検討してください。
  • SQL アラート タスクでは、Databricks SQL アラートのみがサポートされます。 従来のアラートはサポートされていません。

その他のリソース

  • Last updated on