Fabric リアルタイム ハブでの Fabric ワークスペース アイテム イベントの探索 (プレビュー)

  • [アーティクル]

Note

リアルタイム ハブは現在プレビュー段階です。

Fabric ワークスペース項目イベントを使用すると、ワークスペースアイテムに対して特定のアクションが発生したときに通知を受け取ることができます。 たとえば、新しい成果物が作成されたときや、既存の成果物が削除された場合などです。 これらのイベントは、データ パイプラインの実行や、Data Activator アラート機能を使用したメール通知の送信など、Fabric の他のアクションまたはワークフローに対するアラートを作成するために使用できます。 この記事では、リアルタイム ハブで Fabric ワークスペース アイテムのイベントを調べる方法について説明します。

Note

イベントストリームまたはデータ アクティベーターの容量リージョンが次のリージョンにある場合、イベントストリームまたはデータ アクティベーターを介した Fabric イベントの消費はサポートされません: ドイツ中西部、米国中南部、米国2 西部、米国3 西部、インド西部。

Fabric ワークスペース アイテムのイベント詳細ページを表示する

  1. リアルタイム ハブで、[ファブリック イベント] を選択します。

  2. 一覧から [Fabric ワークスペース項目イベント] を選択します。

    [Fabric イベント] ページでの Fabric ワークスペース項目イベントの選択を示すスクリーンショット。

  3. Fabric ワークスペース アイテムのイベント詳細ビューが表示されます。

    Fabric ワークスペース アイテムのイベント詳細ページを示すスクリーンショット。

アクション

詳細ページの上部には、次の 2 つのアクションが表示されます。

  • イベントストリームの作成 - 選択した Fabric ワークスペース アイテムのイベントに基づいてイベントストリームを作成できます。

  • アラートの設定 - 新しい成果物の作成など、Fabric ワークスペース アイテムに対して操作が完了したときにアラートを設定できます。

    Fabric ワークスペース アイテムのイベント詳細ページのアクションを示すスクリーンショット。

このカテゴリの使用方法を確認する

このセクションでは、Fabric ワークスペース アイテムのイベントを使用した成果物を紹介します。 一覧に表示される列とその説明を以下に示します。

列 説明
Name Fabric ワークスペース アイテムのイベントを使用している成果物の名前。
Type 成果物の種類 – Reflex またはイベントストリーム
ワークスペース 成果物が存在するワークスペース。
ソース イベントのソースであるワークスペースの名前。

Fabric ワークスペース アイテムのイベント プロファイル

Fabric ワークスペース アイテムのイベント詳細ページの [プロファイル] セクションを示すスクリーンショット。

イベントの種類

イベント タイプ名 説明
Microsoft.Fabric.アイテムCreateSucceeded このイベントは、リソースに対する作成操作が成功したときにアクティブになります。 たとえば、新しい成果物が正常に作成されたときに生成されるイベントです。
Microsoft.Fabric.アイテムCreateFailed このイベントは、リソースに対する作成操作が失敗したときにアクティブになります。 たとえば、作成時に新しい成果物が失敗したときに生成されるイベントです。
Microsoft.Fabric.アイテムUpdateSucceeded このイベントは、リソースの更新操作が成功したときにアクティブになります。 たとえば、データフローが正常に更新されたときに生成されるイベントです。
Microsoft.Fabric.アイテムUpdateFailed このイベントは、リソースの更新操作が失敗したときにアクティブになります。 たとえば、更新中にデータフローが失敗したときに生成されるイベントです。
Microsoft.Fabric.アイテムDeleteSucceeded このイベントは、リソースの削除操作が成功したときにアクティブになります。 たとえば、データフローが正常に削除されたときに生成されるイベントです。
Microsoft.Fabric.アイテムDeleteFailed このイベントは、リソースの削除操作が失敗したときにアクティブになります。 たとえば、削除中にデータフローが失敗したときに生成されるイベントです。
Microsoft.Fabric.アイテムReadSucceeded このイベントは、リソースに対する読み取り操作が成功したときにアクティブになります。 たとえば、成果物が正常に読み取られたときに生成されるイベントです。
Microsoft.Fabric.アイテムReadFailed このイベントは、リソースの読み取り操作が失敗したときにアクティブになります。 たとえば、読み取り中に成果物が失敗したときに生成されるイベントです。

スキーマ

イベントのトップレベルのデータを次に示します。

プロパティ タイプ 説明設定 例
source string イベントが発生したコンテキストを識別します。 00000000-0000-0000-0000-000000000000
subject string イベント プロデューサーのコンテキストでイベントの件名を識別します。 /workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000
type string 発生元の出来事に関連するイベントの種類を説明する値が含まれます。 Microsoft.Fabric.ItemCreateSucceeded
time timestamp 出来事が発生した日時のタイムスタンプ。 2024-04-23T21:17:32.6029537+00:00
id string イベントの一意識別子。 00000000-0000-0000-0000-000000000000
specversion string クラウド イベント仕様のバージョン。 1.0
dataschemaversion String データベース スキーマのバージョン。 1.0
capacityId string 容量の一意識別子。 00000000-0000-0000-0000-000000000000
domainId string ドメインの一意識別子。 00000000-0000-0000-0000-000000000000

data オブジェクトには、次のプロパティがあります。

プロパティ タイプ 説明設定 例
itemId guid アイテム/成果物の一意識別子。 00000000-0000-0000-0000-000000000000
itemKind string アイテム/成果物の種類。 Notebook, Lakehouse, etc.などのアイテムの種類 ワークスペースアイテムイベントでサポートされていないアイテムの種類については、以下のノートを参照してください
itemName string アイテム/成果物の名前。 Test Notebook
workspaceId guid ワークスペースの一意識別子。 00000000-0000-0000-0000-000000000000
workspaceName string ワークスペースの名前。 Test Workspace
principalId guid ユーザーを表す一意の識別子です。 00000000-0000-0000-0000-000000000000
executingPrincipalType string ユーザーの種類: User

Note

現時点では、次の Power BI 項目の種類 (itemKind) の Fabric ワークスペース項目イベントはサポートされていません。

  • セマンティック モデル
  • ページ分割されたレポート
  • Report
  • アプリ
  • ダッシュボード​

関連するコンテンツ