Fabric Activator でルールを作成する

ストリーミング データをアクティベーターに取り込んだり、 イベントをオブジェクトに割り当てたりすると、データに対して動作するルールを作成できます。 これらのルールのアクティブ化は、電子メールや Teams メッセージなどの通知の送信です。 これらのルールをアクティブ化すると、Power Automate フローの開始などのワークフローをトリガーすることもできます。

アクティベータールールは、イベントFabricイベントや Eventstream 経由で受信したAzure Blob Storageイベントに基づいてアクションをトリガーし、イベントドリブン オーケストレーションを有効にすることもできます。 たとえば、ファイルが BLOB コンテナーに格納されたときに Spark ジョブまたはデータフローを開始できます。 イベント ソースの接続の詳細については、「Fabric Activator 送信先を eventstream に追加するを参照してください。

前提条件

• Microsoft Fabricが有効な容量を持つワークスペース。

Activator を開く

まず、ブラウザーでFabricを開きます。

ナビゲーション ウィンドウで、[作成]>[アクティベーター] を選択します。 [作成] が表示されない場合は、省略記号 (...) を選択してその他のオプションを表示します。

サンプルを試す を選択して、サンプル イベントとオブジェクトが事前に設定されたアクティベーターを作成します。

ルールの条件とアクションを定義する

ルールを使用して、イベントで監視する値、検出する条件、および Activator で実行するアクションを指定します。

ルール データを選択する

Activator Explorer で、設定したルール内で監視するプロパティまたはイベント ストリームを選択します。 プロパティの詳細については、「プロパティの 作成 」セクションを参照してください。

プロパティまたはイベントストリームを選択すると、オブジェクトのインスタンスのサンプルの値のプレビューが表示されます。

新しい Activator ルールを作成する

新しいルールを作成するには、先ほど追加したストリームを選択します。 右側に [ ルールの作成 ] ウィンドウが表示されます。 ルールの [監視 ] セクションには、選択したデータ ストリームが事前に設定されています。

検出する条件を定義する

次に、検出する条件の種類を選択します。 次の内容を確認する条件を使用できます。

• 各イベントで、アクションを実行します。
• 値が満たされたときの各イベントで、アクションを実行します。
• フィールドでグループ化された各イベントで、アクションを実行します (たとえば、Temperature が 30 より大きい場合は、各 PackageId イベントに対して)

最後に、アクションでメールを送信するか、Teams メッセージを送信するかを選択し、[ 作成] を選択します。 後で条件とアクションを変更できます。

[ 定義 ] タブのグラフが更新され、設定した条件を満たすイベントのサンプルが表示されます。

[分析] タブに移動すると、2 つのグラフが表示されます。 最初のグラフには、アクティベーターが追跡しているすべてのオブジェクト ID について、ルールが発生した合計回数が表示されます。 このグラフを使用して、すべてのオブジェクト ID で発生した通知の量を把握します。 2 つ目のグラフは、5 つのオブジェクト ID に対してルールがアクティブ化された合計回数を示しています。 このチャートを使用して、特定のオブジェクト ID がすべての発動するアクティベーションに最も寄与しているかどうかを理解します。

実行するアクションを定義する

最後に、[アクション] セクションを使用して、条件が検出されたときに実行する処理を選択します。

サポートされているアクションの種類を次に示します。

• 電子メール - 指定した受信者に電子メールを送信します。

• Teams - 指定した受信者、グループ チャット、またはチャネルに Teams メッセージを送信します。

• Fabric item - 選択したFabric パイプライン、Fabric ノートブック、Fabric Spark ジョブ定義、Fabric データフロー、またはユーザー データ関数Fabric実行します。 これらのアクションを使用して、イベント ドリブン パイプラインを実装します。 詳細については、「Trigger Fabric items 」を参照してください。

• カスタム操作 - Power Automate フローを有効にする。

アクションの種類によってパラメーターが異なります。 これらのパラメーターには、送信するメール アドレス、Teams チャネルまたはグループ チャット、開始するワークフロー、件名、追加情報 (コンテキスト) などがあります。 [コンテキスト] では、アラート メッセージに含める追加のプロパティを選択できます。

送信するアクションにコンテキストを追加する @ を入力して、プロパティにタグを付けることもできます。 たとえば、 @bikeIdと指定します。

モニター カードのプロパティを集計すると、アクションは集計された値ではなく、プロパティの元の値を送信します。

[ アクションの編集] を選択すると、アクションが送信するメッセージのプレビューを含むエディターと、アクションに詳細情報を追加するためのオプションが表示されます。

ルールのテスト

ルールを作成した後、[テスト アラートを自分に送信] を選択して、ルールをテストします。 このボタンを選択すると、ルールのアクティブ化が "true" である過去のイベントが検索され、そのイベントのアラートがどう表示されるかを確認できるようにアラートが送信されます。

• アクション カードの受信者フィールドに関係なく、テスト アラートは常にユーザーに 送信 されます。
• [テスト アラートを自分に送信] オプションは、ルール条件が "true" の過去のイベントが少なくとも 1 つ存在する場合にのみ有効になります。

ルールの開始および停止

ルールは "停止" 状態で作成されます。 この状態は、データがシステムに流れ込むにつれてシステムがルールを評価していないことを意味し、その結果、ルールはアクションを実行しません。 ルールを定義したら、[ 保存] を選択して開始し 、ルールをアクティブにします。 ルールを開始する準備ができていない場合は、ルールを保存して後で戻ってきてください。 準備ができたら、Activator のツール バーから [開始] を選択して、トリガーの実行とアクションの実行を開始します。

開始すると、ルール カードのタイトル領域に "実行中" と表示されます。 また、Explorer のアイコンは、ルールが実行されていることを示しています。 ルールを開始すると、取り込まれた新しいデータに対して新しいアクティブ化の開始が実行されます。 既に取り込まれたデータに対してルールがアクティブ化されることはありません。 アラートを停止するには、[停止] を選択します。

ルールを変更する場合 (たとえば、検索する条件を変更する)、ツール バーの [ 更新 ] を選択して、実行中のルールで新しい値が使用されていることを確認します。

ルール (またはオブジェクト) を削除すると、データのバックエンド処理が完了するまでに最大 5 分かかることがあります。 削除されたルールは、データを削除した後、数分間、データを監視し、それに応じてアクションを実行し続ける場合があります。

プロパティを作成する

場合によっては、複数のルール間でルール ロジックを再利用する必要があります。 再利用可能な条件またはメジャーを定義するプロパティを作成し、そのプロパティを複数のルールから参照します。

プロパティを作成するには、目的のオブジェクトに追加したストリームを選択し、リボンから [新しいプロパティ ] を選択し、ルール ロジックで使用するプロパティを選択します。

プロパティを定義したら、1 つ以上のルールから参照できます。 この例では、温度 プロパティ 薬には熱すぎる を参照します。

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

サンプルの Eventstream を削除するには、Package delivery events Eventstream の右側にある省略記号 (...) を選択し、[削除] を選びます。

次の手順

関連するコンテンツ

• Activator ルールの概要
• Activator のチュートリアル