Fabric リアルタイム ハブでワークスペースアイテムのイベントを探る

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

注

Eventstream または Fabric Activator を介した Fabric イベントと Azure イベントの使用は、Eventstream または Activator の容量リージョンが次のリージョンにある場合はサポートされません:インド西部、イスラエル中部、韓国中部、カタール中部、シンガポール、アラブ首長国連邦中部、スペイン中部、ブラジル南東部、米国中部、米国中南部、米国西部 2、米国西部 3。

注

2025 年 3 月 21 日より、Microsoft.Fabric.ItemReadSucceeded および Microsoft.Fabric.ItemReadFailed イベントの種類は非推奨となりました。 そのため、組織内のユーザーには、Fabric ワークスペースのサブスクリプション (Eventstream またはアラート) を作成するときに、これらのイベントの種類は表示されません。

これらのイベントの既存のサブスクリプション (Eventstream またはアラート) では、2025 年 3 月 21 日にイベントの受信を停止します。

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

1. リアルタイム ハブで、[Fabric イベント] を選びます。

2. 一覧から [Fabric ワークスペース アイテム イベント] を選びます。

   

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

   

アクション

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

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

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

  

このカテゴリを使用しているものを確認する

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

列	説明
Name	Fabric ワークスペース項目イベントを使用している成果物の名前。
タイプ	成果物の種類 – Activator または Eventstream
ワークスペース	成果物が存在するワークスペース。
ソース	イベントのソースであるワークスペースの名前。

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

イベントの種類

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

スキーマ

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

プロパティ	タイプ	説明	例
source	文字列	イベントが発生したコンテキストを識別します。	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	タイムスタンプ	出来事が発生した日時のタイムスタンプ。	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	一意識別子	アイテム/成果物の一意識別子。	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

注

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

• セマンティック モデル
• 改ページ対応レポート
• レポート
• アプリ
• ダッシュボード​

購読許可

詳細については、Fabric イベントのサブスクライブ アクセス許可を参照してください。

関連するコンテンツ

• Azure Blob Storage イベントの探索