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