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 パイプライン、データフロー (プレビュー)、ノートブック、または Spark ジョブを起動するようにアラートを構成するには、次の手順に従います。

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

   

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

3. [パイプライン]、[データフロー]、[ノートブック]、および [Spark ジョブの種類] で、[パラメーターの追加] を選択し、Fabric 項目のパラメーターの名前とその値を指定します。 複数のパラメーターを追加できます。

   

   [関数の 実行 ] オプションを選択した場合は、次の手順に従います。

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

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

      

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

カスタム アクション

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

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

   

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

   

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

   

[保存場所] セクション

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

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

   

ルールを作成する

[ ルールの追加 ] ページで、[ 作成 ] を選択してルールを作成します。 ルールの作成が成功すると、[クエリの実行] フィールドで設定した頻度に基づいて 実行 されます。 クエリから結果が返された場合、ルールによって設定したアクションがトリガーされます。

[ルール] ウィンドウ

ルールの作成が成功すると、ルールの一覧が表示された [ルール] ウィンドウが表示されます。 [ルール] ウィンドウでは、次のタスクを実行できます。

• トグル ボタンを使用して、ルールを停止または実行します。

• [...] を選択し、[編集] を選択してルールを編集し、[削除] を選択してルールを削除し、[アクティブ化で開く] を選択して、作成されたルールを含むファブリック アクティベーター項目を開きます。

  

サンプル アラート

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

関連するコンテンツ

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