チュートリアル: Fabric アクティベーター ルールを作成してアクティブ化する

Microsoft Fabricの Fabric Activator を使用すると、データ ストリーム内のパターンまたは条件を検出したときにアクションを実行できます。 Fabric Activatorを初めて使用する場合は、「 Fabric Activatorとは何か」をご覧ください。 このチュートリアルでは、Fabric Activator に含まれるサンプル データを使用して、次のタスクを完了します。

前提条件

開始する前に、Fabric容量のワークスペースが必要です。 Fabricワークスペースの詳細については、Workspaces に関する記事を参照してください。 Fabricがない場合は、試用版を開始するように求められます。

サンプルのアクティベーターを作成してください

1. Fabricのホームページの左側ナビゲーションペインで省略点を選択し、その後「作成」を選択します。

   

2. 作成ページの Real-Time Intelligenceの下でActivatorを選択します。

   

3. [ アクティベーター ] ページで、[ サンプルを試す] を選択します。

   

データを検索する

このステップでは、サンプルが構築されるイベントストリームデータを探ります。

新しいアクティベーターアイテムには エクスプローラー セクションがあります。 下にスクロールし、[Package delivery events] ストリームを選択します。

これらのイベントは、配達中の荷物のリアルタイムの状態を示します。

受信イベントを確認し、ライブ テーブル内のイベント データにカーソルを合わせます。 各データ ポイントに、イベントに関する情報が含まれています。 すべて表示するには、スクロールしなければならない場合があります。

ルールを調べる

ルールを使用して、監視したいイベント値、検出したい条件、そしてFabricアクティベータに実行させたいアクションを指定します。

エクスプローラー ペインには、このアクティベーターのオブジェクト (イベント ストリームなど) が表示されます。 配信イベントは、パッケージ配信イベント Eventstream から作成されたオブジェクトの 1 つです。

1. エクスプローラー ペインで、[Delivery events] というオブジェクトを選択します。 [Package delivery events] イベント ストリームのデータを使うオブジェクトに関するルールを作成できます。 たとえば、荷物の温度をチェックするルールなどです。

   

2. [Events by object ID] セクションは [Package ID] によって編成されていることがわかります。 [Package ID] は、各荷物を一意に識別する列 ID です。 このユニークなIDを使ってパッケージオブジェクトにパッケージイベントを割り当てます。

   

3. [Too hot for medicine] という [Temperature] ルールを選択します。 最も右のパネルで「 定義 」パネルを見て、ルールの仕組みを確認してください。

   

4. [監視] セクションで、[Temperature] を選択します。 温度の値は、Delivery events テーブルの Temperature 列から取得されます。 前のスクリーンショットで Temperature 列を確認できます。

   

5. [ 条件] セクションには、 20 °C を超える 温度を監視するルール条件が表示されます。

   

6. さらに下にある [プロパティ フィルター] までスクロールします。 この規則は、医薬品を含むパッケージにのみ適用されます。 Delivery events テーブルで、ルールは Special care contents という列を確認しています。 Special care contents 列では、一部のパッケージは Medicine という値を持っています。

   

7. アクションまでスクロールしてください。 条件が満たされたら、以下のいずれかの行動を選択してください。

   1. 電子メール通知を送信する: 自分または組織内の他のユーザーに電子メールを送信します。

      1. [ アクションの選択] で、[ 電子メールの送信] を選択します。
      2. Toについては、受信者のメールアドレスを入力するか、ドロップダウンリストからメールアドレスの価値を持つプロパティを選択します。 メールアドレスはデフォルトでここに入力されています。
      3. [ 件名] に、電子メール通知の件名を入力します。
      4. [ 見出し] に、メール通知の見出しを入力します。
      5. [メモ] には、電子メール通知のメモを入力します。

         注

         主題、見出し、注釈を入力した場合、 @ と入力するか、テキストボックスの横にあるボタンを選択することでデータ内のプロパティを参照できます。 たとえば、「 @PackageId 」のように入力します。

      6. コンテキストでは、メール通知に含めたいドロップダウンリストから値を選択します。

      

   2. Send Microsoft Teams notification: 個人、グループ チャット、またはチャネルにMicrosoft Teams通知を送信します。 タイトルとメッセージの内容をカスタマイズできます。

      1. アクションを選択するには、Teams>Message to Individuals、グループチャットメッセージ、またはChannel Postを選択します。
      2. 選択内容に応じて、次のいずれかの手順に従います。
         • 「個人へのメッセージ」を選択した場合は、受信者のメールアドレスを入力するか、ドロップダウンリストからメールアドレスの価値を持つプロパティを選択してください。 条件が満たされると、Fabric Activatorは指定された個人にTeamsメッセージを送信します。
         • グループチャットメッセージを選択した場合は、ドロップダウンリストからグループチャットを選択してください。 条件が満たされると、Fabric Activatorはグループチャットにメッセージを投稿します。
         • チャンネル 投稿を選択した場合は、ドロップダウンリストから チーム と チャンネル を選択してください。 条件が満たされると、Fabric Activatorは選択したチャネルにメッセージを投稿します。
      3. [見出し] には、Teams 通知の見出しを入力します。
      4. [メモ] には、Teams 通知のメモを入力します。

         注

         主題、見出し、注釈を入力した場合、 @ と入力するか、テキストボックスの横にあるボタンを選択することでデータ内のプロパティを参照できます。 たとえば、「 @PackageId 」のように入力します。

      5. コンテキストでは、Teams通知に含めたい値をドロップダウンリストから選択してください。

      

   3. Fabricアクティビティを実行する:条件を満たした際にFabricパイプライン、Dataflow、Sparkジョブ、ノートブック、関数、コピージョブ、またはビジネスイベント(プレビュー)を起動するアラートを設定するには、以下の手順に従ってください。

      1. 選択アクションでは、パイプラインの実行、データフローの実行、Sparkジョブの実行、Notebookの実行、関数の実行、コピージョブの実行、またはビジネスイベントの公開(プレビュー)を選択してください。

      2. 実行するFabric項目の選択で、一覧からFabric項目 (パイプライン、データフロー、ノートブック、Spark ジョブ、関数、コピー ジョブ、または発行ビジネス イベント (プレビュー)) を選択します。

      3. パラメータを追加を選択し、Fabricアイテムのパラメータ名と値を指定します。 複数のパラメーターを追加できます。 アラート データからパラメーターを渡すには、「 @ 」と入力するか、テキスト ボックスの横にあるボタンを選択します。 たとえば、「 @PackageId 」のように入力します。 コピージョブはパラメータを受け付けないので、このステップは適用されません。

         

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

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

         

      2. まず、ルールを作りましょう。 その後、カスタム アクションをトリガーする (Power Automate フロー) の手順に従って、カスタム アクションの設定を完了します。

      3. カスタムアクションを作成した後、 定義 ペインで「 アクション選択 」ドロップダウンリストからカスタムアクションを選択します。

8. 選択したアクションを設定した後、Activatorルールを保存するために 「作成 」を選択してください。

Fabric アクティベーター ルールを作成しました。 このルールは 、パッケージ配信イベント イベントストリームに対して実行されます。 この規則は、薬が入っているパッケージを対象とし、温度が20度を超えているかどうかを確認します。 気温が20度を超えると、ルールはTeamsメッセージを送信します。

このサンプルのアクティベーターアイテムには他のルールも含まれています。 自分のペースで探求して、どのように機能するかを見てみてください。

ルールを開始する

ルールの作成に使用されるイベントとオブジェクトを理解したら、ルールを開始します。

1. [Too hot for medicine] を選択します。

2. 必要に応じて、[テスト アクションを自分に送信] を選択してテスト メッセージを送信します。 まず、自分が受信者であることを確認 します。

   

3. 次のようなメッセージが表示されます。

   

4. [スタート] を選択します。 このアクションにより、ルールがアクティブになります。 薬の荷物が熱くなりすぎている場合は、常に Teams メッセージを受信します。 ルールは 1 時間ごとに数回トリガーされます。

   

5. 後で、リボンの [停止 ] ボタンを使用してルールをオフにすることができます。

   

オブジェクトを作成します

次に、自分だけのオブジェクトを作りましょう。 このセクションでは 、パッケージ オブジェクトを削除し、次のセクションで使うプロパティで再作成してルールを作成します。

1. エクスプローラー ウィンドウで、[パッケージ] を右クリックし、[削除] を選択します。 [ アイテムの削除 ] ウィンドウで、[削除] を選択 します。

   

2. パッケージ配信イベント ストリームを選択し、リボンの [新しいオブジェクト] を選択します。

   

3. 右側の [ビルド オブジェクト ] ウィンドウで、次の手順に従います。

   1. 新しいオブジェクトに Package2 という名前を付けます。

   2. 一意の ID として PackageId を選択します。

   3. オブジェクトのプロパティとして HoursInTransit と City を選択します。

   4. ［作成］ を選択します

      

規則を作成する

平均移動時間が25時間を超えたときに通知するルールを作成しましょう。

1. 新しい HoursInTransit プロパティを選択します。 リボンから、[新しいルール] を選択します。

   

2. [定義] ウィンドウで、次の手順に従います。

   1. [監視] では、監視する属性を選択し、必要に応じてフィルターを追加します。

   2. 条件については、輸送時間が25を超えると条件がトリガーされるように設定してください。

   3. [アクション] で、Teams またはメールでメッセージを送信するオプションのいずれかを選択します。

   4. 保存 を選択します。

      

3. [エクスプローラー] ウィンドウの [HoursInTransit ] にルールが表示されます。 ルールを選択します。 中央のウィンドウで、上部にある鉛筆アイコンを選択し、名前を ターゲットより上の平均輸送時間に更新します。

   

4. 右側の [定義 ] ウィンドウで、[ HoursInTransit] を選択します。 次に、[集計の追加]、> の順に選択します。

   

5. 集計 ウィンドウ サイズ を 5 分、 ステップ サイズ を 5 分に設定し、[保存] を選択 します。

   

6. 集計を反映して [監視] のグラフが更新され、[監視] のグラフ ルールは次のようになります。

   アクティベーターチュートリアルの平均通過時間グラフのスクリーンショット。

7. [Send me a test action] (テスト アクションを自分に送信) ボタンを選択して、ルールをテストします。 警告を受け取ることを確認します。 メールを使用する場合、到着するまでに 1 ~ 2 分かかる場合があります。

   

8. [定義] ウィンドウで [保存して開始] を選択するか、リボンの [開始] を選択して、ルールを開始します。

   

   最初のオブジェクトとルールを作成できました。 次のステップとして、 Package2 オブジェクトで他のルールを設定してみてください。

   独自のデータで Fabric Activator を使用する準備が整ったら、Fabric Activatorのためのデータの取得の記事にある手順に従ってください。

リソースをクリーンアップする

チュートリアルの一環として作成したルールを完了したら、それらを停止します。 ルールを停止しないと、ルールの通知を受け取り続けることになります。 バックグラウンド処理の料金が発生する場合もあります。 各ルールを順番に選択して、リボンの [停止] ボタンを選択します。

関連するコンテンツ

• チュートリアル: agentic AI を使用してエンド ツー エンドのアクティベーター ルールを作成する
• Fabric Activator とは何ですか？

Microsoft Fabricの詳細については、以下を参照してください。

• Microsoft Fabricとは