チュートリアル: Activator ルールを作成してアクティブにする

このチュートリアルでは、Fabric Activator に含まれているサンプル データを使います。 サンプル データを使って、次のタスクを実行します。

• サンプル アクティベーターを確認する
• データを検索する
• ルールを調べる
• ルールを開始する
• オブジェクトを作成します
• 規則を作成する

前提条件

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

サンプル Activator アクティベーターを作成する

まず、Fabric 容量を持つワークスペースを開きます。

1. Fabric ホームページから、Fabric 容量を持つワークスペースを選択し、[作成]>[Activator] を選択します。

   

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

   

データを検索する

この手順では、このサンプルが基づいているイベント ストリーム データを調べます。

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

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

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

ルールを調べる

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

エクスプローラー ペインには、このアクティベーターのオブジェクト (イベント ストリームなど) が表示されます。 Delivery events は、オブジェクトの 1 つです。

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

   

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

   

3. [Too hot for medicine] という [Temperature] ルールを選択します。 [定義] ペインをスクロールして、ルールの動作を確認します。

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

   

5. [条件] まで下にスクロールします。 このルールでは、50 より大きくなる温度を監視しています。

6. [スコープ] までさらに下にスクロールします。 このルールは、薬が含まれている荷物にのみ適用されます。 Delivery events テーブルで、ルールは SpecialCare という列を確認しています。 SpecialCare 列では、一部の荷物は Medicine という値を持っています。

   

7. 最後に、[アクション] まで下にスクロールします。 条件が満たされている場合、ルールによって Teams メッセージが送信されます。

ここでは Activator ルールを作成しました。 このルールは、Package delivery events イベント ストリームに対して実行されます。 このルールは、薬が含まれている荷物を探し、温度が 50 度を超えたかどうかを確認します。 温度が 50 度を超えると、Teams メッセージが送信されます。

他のルールの動作を見てみましょう。

ルールを開始する

これで、ルールの作成に使われるイベントとオブジェクトについて理解できました。 次の手順では、ルールを開始します。

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

2. 必要に応じて、[テスト] を選択してテスト メッセージを送信します。 まず、自分が [受信者] であることを確認します。 メッセージを受信すること、それが予想どおりに表示されることを確認します。

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

4. 後ほど、[停止] ボタンを使ってこのルールをオフにできます。

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

次に、独自のオブジェクトを作成します。 このセクションでは、Package オブジェクトを削除します。 次に、それを再作成して、配送時間が 100 を超えている輸送中の荷物の状態を追跡します。

1. [Package] オブジェクトを選択して削除します。
2. [Package delivery events] ストリームを選択します。
3. リボンで、[新しいオブジェクト] を選択します。
4. 新しいオブジェクトに「Package2」という名前を付け、一意の ID として [Package ID] を選択します。
5. オブジェクトのプロパティとして、HoursInTransit と City を追加します。
6. ［作成］ を選択します

新しいルールの作成

配送中の輸送時間がしきい値を超えた場合に警告するルールを作成します。

1. 新しい HoursInTransit プロパティを選択します。 リボンから、[新しいルール] を選択します。 ヘッダーから鉛筆アイコンを選択して、ルールの名前を編集します。 「Average transit time above target」という名前を付けます。 Package2 オブジェクトは次のようになります。

1. [定義] ペインで、[HoursInTransit] を選択します。 次に、[オプションの表示]>[集計の追加]>[平均] を選択します。 集計の [ウィンドウ サイズ] を 1 時間、[ステップ サイズ] を 1 時間に設定します。 集計を反映して [監視] のグラフが更新され、ルールは次のようになります。

   

2. [条件] ステップで、平均輸送時間が 25 を超えたときを検出します。 この条件が満たされるたびに警告するようにルールを設定します。 この手順を完了すると、[条件] のグラフが更新され、ルールは次のようになります。

   

3. ルールのアクションを指定します。 Teams メッセージまたはメールを送信することを選択できます。 どのように表示するかに応じてアクションをカスタマイズしてください。

4. [アクションのテスト] ボタンを選択して、ルールをテストします。 警告を受け取ることを確認します。 メールを使用する場合は、到着するまでに 1、2 分かかる場合があります。

5. [保存して開始] を選択して、ルールを開始します。

最初のオブジェクトとルールを作成できました。 次の手順として、Package2 オブジェクトに対する他のルールを設定してみてください。 独自のデータに対して Activator を使う準備ができたら、Activator のデータの取得に関する記事の手順に従います。

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

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

関連するコンテンツ

• Activator とは
• Activator の概要

Microsoft Fabric の詳細についても確認してください。

• Microsoft Fabric とは