Fabric Activator の data ソースを設定したら、イベントをオブジェクトに割り当てます。 追跡する個別のエンティティ (デバイス、マシン、パッケージ、ストアなど) がある場合に、イベントをオブジェクトに割り当てます。 各オブジェクトは、一意識別子を使用して、時間の経過にともなって個々のインスタンスを追跡します。 この記事の例では、パッケージが追跡されるエンティティである Fabric Activator に付属する Package 配信イベント サンプルを使用します。 独自のデータを扱うときは、独自の値を使用してください。
注
query ベースのソース (Power BI、KQL クエリセット、または Real-Time ダッシュボード) を使用する場合、Activator はデータ バインディングを異なる方法で処理し、オブジェクトを自動的に作成する可能性があります。 この記事は、主にストリーミング ソース (イベントストリーム、Fabric イベント、Azure イベントなど) に適用されます。
前提条件
- Microsoft Fabric 対応の容量を持つワークスペース。
- イベントストリームなどの Activator 項目に接続されているストリーミング データ ソース。 ストリーミング データ ソースを設定するには、「 Eventstreams からのインジェスト」を参照してください。
新しいオブジェクトにデータを割り当てる
ストリーミング データ ソースが接続されている Activator 項目を開くか、パッケージ配信イベントのサンプル イベントストリームを使用するサンプル アクティベーターを作成します。
注
リボンで新しいオブジェクトを使用できるようにするには、アクティベーター項目が実行されている必要があります。 起動していない場合は、リボンから [スタート] を選択し、ワークスペースに戻り、Activator 項目をもう一度開きます。
エクスプローラー ウィンドウで、オブジェクトに割り当てるイベントストリームを選択します。 たとえば、[ パッケージ配信イベント ] イベントストリームを選択します。
リボンから [新しいオブジェクト ] を選択します。 [ オブジェクトのビルド ] ウィンドウが開き 、[新しいオブジェクトの作成 ] が既定で選択されています。 次の値を指定します。
- オブジェクト名: 追跡するエンティティの名前。
- 一意識別子: 監視している各インスタンスを一意に識別するイベント内の列。
この例では、オブジェクト名として [パッケージ ] を選択し、一意の識別子として [パッケージ ID ] を選択します。
![Activator の [オブジェクトのビルド] ペインのスクリーンショット。](media/activator-assign-data-objects/activator-assign-data-objects-01.png)
を選択してを作成します。
Activator によってオブジェクトが作成されると、そのイベントストリームから受信した列が表示されます。 イベントは、一意識別子列の値によって整理されます。
既定では、グラフには、 過去 24 時間の使用可能なオブジェクト インスタンスのうち 5 つのイベントが表示されます。 グラフの右上隅にある [インスタンス ] セレクターと [ 時間 ] セレクターを使用して、これらの値を変更します。 [ 自動更新] を切り替えて、グラフが自動的に更新されるかどうかを制御することもできます。
データを既存のオブジェクトに割り当てる
1 つのオブジェクトに複数のイベントストリームを割り当てることができます。 1 つのオブジェクトに複数のストリームを割り当てると、同じエンティティに関するデータが複数のストリームに分散する場合に便利です。 たとえば、緩やかに変化する参照データが 1 つのイベントストリームに到着し、高速に移動する更新が別のイベント ストリームに到着した場合などです。 既存のオブジェクトにデータを割り当てる場合は、最初にオブジェクトを作成したときに使用したのと同じ ID を参照する 一意識別子 を選択します。 それ以外の場合、プロパティとルールによって予期しない結果が生成されます。
2 つのイベントストリームを使用した完全なチュートリアルについては、「 アクティベーター ルールで複数のイベントストリームを結合する」を参照してください。
複数のオブジェクトにイベント ソースを割り当てる
1 つのイベント ソースの列を複数のオブジェクトに割り当てることができます。 1 つのイベント ソースを複数のオブジェクトに割り当てると、イベント ソースに複数のエンティティのデータが含まれている場合に便利です。 たとえば、サンプルの Packages イベントストリームには、 PackageID 列と City 列の両方が含まれています。 Package オブジェクトを作成すると、個々のパッケージのルールを追跡および設定できます。 たとえば、特定のパッケージの温度がしきい値を超えたときにアラートを生成します。 同じストリームから別の City オブジェクトを作成すると、都市レベルで条件を追跡できます。 たとえば、都市全体で転送中のパッケージの合計数を監視したり、市区町村の配送量が予期せず減少した場合を検出したりします。 各オブジェクトの種類には独自のルールとプロパティがあるため、1 つのイベントストリームの個々のレベルと集計レベルの両方を監視して操作できます。
「 新しいオブジェクトにデータを割り当てる 」の手順に従って、最初のオブジェクトを作成します。 たとえば、 PackageID を一意識別子として使用して Package オブジェクトを作成します。
ワークスペースに戻り、Activator 項目をもう一度開き、[エクスプローラー] ウィンドウで同じイベント ストリームを選択します。
リボンから [新しいオブジェクト ] を選択します。
[ オブジェクトのビルド ] ウィンドウで、[ 新しいオブジェクトの作成 ] が既定で選択されています。 2 番目のオブジェクトの名前を入力し、一意の識別子として別の列を選択します。 たとえば、オブジェクトに City という名前を付け、一意識別子として [City ] を選択します。
を選択してを作成します。
同じイベントストリームから作成する追加のオブジェクトごとに、手順 2 から 5 を繰り返します。 オブジェクトのプロパティの作成とメジャーの集計の詳細については、「 プロパティの作成」を参照してください。