Fabric Warehouse SQL クエリでアラート ルールを作成する

この記事では、Warehouse SQL クエリでアラートを作成する方法について説明します。 SQL クエリでアラートを作成すると、クエリが結果を返したときにアラートが発生します。 クエリが値を返さない場合、アラートは発生しません。

アラート ルールを作成する

ウェアハウス SQL クエリの SQL クエリ エディターで、SQL クエリを入力して実行し、リボンの [ ルールの作成 ] を選択します。

次のセクションに進み、ルールの作成を開始します。

詳細セクション

[ ルールの追加 ] ページの [ 詳細 ] セクションの [ ルール名] に、ルールの名前を入力します。

監視セクション

1. [ 監視 ] セクションの [ソース] で、クエリを実行したテーブルにソースが設定されていることを確認します。
2. [クエリ] で、SQL クエリ エディターで実行したクエリが表示されることを確認します。 完全なクエリを表示するには、[ 詳細を表示] を選択します。
3. [ クエリの実行] フィールド で、クエリを実行する頻度を選択して条件を確認します。

条件セクション

[チェック] フィールドで、[On each event]\(各イベント\) が選択されていることを確認します。 この設定は、クエリが実行されるたびにアラートが評価されることを意味します。

アクションセクション

[ アクション ] セクションで、次のいずれかのアクションを選択します。

Email

条件が満たされたときに電子メールを送信するようにアラートを構成するには、次の手順に従います。

1. [ アクションの選択] で、[ 電子メールの送信] を選択します。

2. [ 宛先] で、受信者の メール アドレス を入力するか、ドロップダウン リストを使用して、値が電子メール アドレスであるプロパティを選択します。

3. [ 件名] に、メールの件名を入力します。

4. [ 見出し] に、メールの見出しを入力します。

5. [ メモ] には、メールのメモを入力します。

   注

   件名、見出し、またはメモを入力するときは、「 @ 」と入力するか、テキスト ボックスの横にあるボタンを選択して、データ内のプロパティを参照できます。 たとえば、「 @BikepointID 」のように入力します。

6. [コンテキスト] で、コンテキストに含める値をドロップダウン リストから選択します。

   

Teams メッセージ

条件が満たされたときに個人またはグループ チャットまたはチャネルに Teams メッセージを送信するようにアラートを構成するには、次の手順に従います。

1. [アクションの選択] で、[Teams ->個人へのメッセージ または グループ チャット メッセージ]、または チャネルの投稿 を選択します。

2. 前の手順で選択したオプションに応じて、次のいずれかの手順に従います。

   • [ 個人へのメッセージ ] オプションを選択した場合は、受信者の メール アドレス を入力するか、ドロップダウン リストを使用して、値が電子メール アドレスのプロパティを選択します。 条件が満たされると、Teams メッセージが指定された個人に送信されます。
   • [グループ チャット メッセージ] オプションを選択した場合は、ドロップダウン リストからグループ チャットを選択します。 条件が満たされると、メッセージがグループ チャットに投稿されます。
   • [チャネル投稿] オプションを選択した場合は、チームとチャネルを選択します。 条件が満たされると、チャネルにメッセージが投稿されます。

3. [見出し] には、Teams メッセージの見出しを入力します。

4. [メモ] には、Teams メッセージのメモを入力します。

   注

   見出しやメモを入力するときは、「 @ 」と入力するか、テキスト ボックスの横にあるボタンを選択して、データ内のプロパティを参照できます。 たとえば、「 @BikepointID 」のように入力します。

5. [コンテキスト] で、コンテキストに含める値をドロップダウン リストから選択します。

   

Fabric アクティビティを実行する

アクティベータールールは、次のFabric項目タイプのいずれかで定義されたFabricアクティビティを実行できます。

• データフロー
• パイプライン
• Spark ジョブ
• Notebook
• 機能
• コピー作業
• ビジネスイベントの公開 (プレビュー)

Fabric アクティビティを起動するようにルールを構成するには、次の手順に従います。

1. [ Select action]\(選択アクション\) で、[Run Fabric Activities]\(ファブリック アクティビティの実行\) セクションで適切なファブリック項目の種類を選択します

   

2. Fabric のアイテムを選択して実行で、一覧から Fabric のアイテムを選択します。

3. パイプライン、Dataflow、Notebook、Sparkジョブ、Publishビジネスイベント(プレビュー)タイプでは、「パラメータを追加」を選択し、Fabricアイテムのパラメータ名と値を指定します。 複数のパラメーターを追加できます。 コピージョブタイプはパラメータを受け付けていません。

   

実行関数

[関数の 実行] を選択した場合は、次の手順に従って関数を選択し、その関数のパラメーターを指定します。

1. [関数] で、一覧から関数を選択します。

2. 関数のパラメーターの場合は、次の例に示すように、関数に定義されている各パラメーターの値を指定します。

   

   データのプロパティを使用するには、「 @ 」と入力するか、テキスト ボックスの横にあるボタンを選択します。 たとえば、「 @BikepointID 」のように入力します。

ビジネスイベントの公開 (プレビュー)

[ ビジネス イベントの発行 (プレビュー)]を選択した場合は、次の手順に従ってスキーマ レジストリからビジネス イベント スキーマを選択し、そのスキーマのパラメーターを指定します。

1. [ ビジネス イベントの発行 (プレビュー)]を選択すると、[ ビジネス イベントの選択 ] ウィンドウが表示されます。

2. このウィンドウで、スキーマ レジストリに登録されているスキーマの一覧からビジネス イベント スキーマを選択します。 検索ボックスにスキーマの名前を入力して、スキーマを検索することもできます。

   

3. ビジネス イベントのパラメーターの場合は、次の例に示すように、スキーマに定義されている各パラメーターの値を指定します。

カスタム アクション

条件が満たされたときにカスタム アクションを呼び出すアラートを構成するには、次の手順に従います。

1. [ アクションの選択] で、[ カスタム アクションの作成] を選択します。

   

2. 「アクション」セクションで説明したように、最初にルールを作成してから、カスタム アクションのトリガー (Power Automate フロー) の手順に従ってカスタム アクションのセットアップを完了します。

   

3. カスタム アクションを作成した後、ルールの [定義 ] ウィンドウで、[アクション ] ドロップダウン リスト からカスタム アクションを選択します。

   

[保存場所] セクション

1. [ 保存場所 ] セクションの [ワークスペース] で、Fabric アクティベーター項目を作成するワークスペース、または既に存在するワークスペースを選択します。

2. [項目] で、既存のアクティベーター項目を選択するか、新しく作成します。 新しいアクティベーター項目を作成するには、[ 新しい項目の作成] を選択し、アクティベーター項目の 名前 を入力します。

   

ルールを作成する

1. [ ルールの追加 ] ページで、[ 作成 ] を選択してルールを作成します。 ルールの作成が成功すると、[クエリの実行] フィールドで設定した頻度に基づいて 実行 されます。 クエリから結果が返された場合、ルールによって設定したアクションがトリガーされます。
2. [ルール] ウィンドウに ルール が表示されます。 ルールを選択して詳細を表示したり、編集したり、削除したり、Activator で開いたりすることができます。

[ルール] ウィンドウ

[ ルール ] ウィンドウでは、次のタスクを実行できます。

• トグル ボタンを使用して、ルールを開始または停止します。 ルールが停止すると、ルールは実行されません。アラートは送信されません。 いくつかのサンプル アラートが表示されたら、ルールを停止して、送信するアラートが多くなりすぎないようにします。 アラートを受信する場合は、ルールをもう一度開始できます。

• [ 編集 ] ボタンを使用して、SQL クエリ エディター ページを離れずにルールを編集します。 ルールの詳細、条件、アクションを編集し、場所を保存できます。

• [削除] ボタンを使用してルールを削除します。

• [アクティベータで表示] を選択して、アクティベータでルールを開きます。 ルールの詳細を表示したり、編集したり、Activator で削除したりできます。 Activator で表示すると、トリガーされた日時や送信されたアラートなど、ルールの履歴も表示されます。

  [アクティベーター] ページで イベント名を選択し、[ ソースの管理 ] を選択して、アラートをトリガーした SQL クエリを表示します。 クエリ リンクを選択すると、SQL クエリ エディター ページに戻ります。

  

サンプル アラート

アラートがトリガーされたときに受信するアラート Teams メッセージの例を次に示します。

関連するコンテンツ

• KQL クエリセットにアラートを作成する
• Real-Time ハブのイベントストリームにアラートを設定する
• ワークスペースアイテムイベントにアラートを設定する