KQLデータベースでエンティティ図を閲覧

Real-Time インテリジェンスでは、KQL データベース項目の系列と関係を表示できます。 このビューを使用すると、データベース エンティティ間のリレーションシップを視覚的に調べ、ソースから宛先へのデータ フローを理解し、明確なグラフ表現を提供できます。 エンティティダイアグラムを使用すると、データベースを効率的に管理し、これらのエンティティがどのように相互作用するかをより深く理解することができます。 このエンティティの視覚的な表現により、データベース管理が簡素化され、データ構造を最適化できるため、依存関係を追跡し、迅速にアクションを実行しやすくなります。

Fabric のワークスペース系列の詳細については、「 系列」を参照してください。

[前提条件]

• Microsoft Fabric 対応の容量を持つワークスペース
• ビュー権限を持つ KQL データベース

インジェストの詳細を有効にするユーザーの場合:

• エンティティ図でインジェストの詳細を表示するためのデータベース管理者またはデータベース モニターのアクセス許可。 詳細については、「ロールベースのアクセス制御」 を参照してください。

エンティティ ダイアグラム ビューを開く

ビューにアクセスするには、目的の KQL データベースを参照し、[ エンティティ ダイアグラム] を選択します。

エンティティ ダイアグラム ビューには何が表示されますか?

エンティティ ダイアグラム ビューを開くと、KQL データベース内のすべての項目間の依存関係が表示されます。

エンティティ ダイアグラム ビューには、次の情報が表示されます。

• Tables
• 更新ポリシー
• 外部テーブル
• 簡略化された手順
• マテリアライズド・ビュー
• Functions
• 連続エクスポート
• データベース間エンティティ
• Eventstreams

項目を選択すると、データベース内の他の項目とのリレーションシップを表示できます。 エンティティ図は、その項目に関連するすべての項目を強調表示し、残りを暗くします。

データ ソース

図に示されているデータソースには、Eventstream、Azure Storage、Azure Event Hubs、Business Eventsが含まれます。 データソースの詳細、マッピング、データ形式、接続状況、取り込みされたレコード数などを確認できるようになりました。 もし接続が不要なら、エンティティ図から直接削除できます。

エンティティ図ビューをフィルタリングしてください

エンティティタイプによるフィルター

図に表示したいエンティティタイプを選択するには 、エンティティタイプ ドロップダウンフィルターを使ってください。 テーブル、関数、具現化されたビューショートカット、データソースから選択できます。 このフィルターは特定のエンティティタイプに焦点を当てるのを助け、KQLデータベース内の関係や依存関係の分析を容易にします。

取り込み時間範囲で絞り込む

インジェスの詳細を表示したい時間帯を選択するには 、Ingestion ドロップダウンフィルターを使ってください。 このフィルターは、該当するエンティティのカードにインジェス情報を追加し、時間経過によるデータフローやインジェスパターンを分析できます。

特定の関数やテーブルによるフィルタ

エンティティ図のビューは、左側のナビゲーションペインから特定の関数やテーブルを選択してフィルタリングします。 このフィルターは特定の関数やテーブル、関連するエンティティに集中しやすく、KQLデータベース内の関係や依存関係の分析を容易にします。

スキーマ違反

スキーマ違反は、データベース エンティティ間の不整合または破損した参照を特定するのに役立ちます。 スキーマ違反の例を次に示します。

• 関数は、存在しなくなったテーブルまたは列を参照します。
• 関数は、存在しなくなった別の関数を参照します。
• 関数は、正しくない数または型のパラメーターを持つ関数を参照します。
• 関数は、データ型が変更された列を参照します。
• 更新ポリシーは、存在しなくなった関数またはソース テーブルを参照します。
• 更新ポリシーは、出力スキーマがターゲット テーブル スキーマと一致しない関数を参照します。
• インジェスト マッピングが無効です (たとえば、マッピングで定義されている 1 つ以上の列がターゲット テーブルに存在しません)。
• 連続エクスポートが無効です (参照先のテーブルや列が見つかりませんでした)。
• 外部テーブルにアクセスできないのは、ストレージの場所が存在しないか、アクセス許可が不十分である可能性があるためです。

[スキーマ違反の表示] を有効にすると、影響を受けるエンティティがダイアグラム内で直接強調表示されます。 スキーマ違反インスタンスをクリックすると、違反の詳細が表示されたサイド ウィンドウが開きます。

この機能を使用すると、破損した依存関係をすばやく見つけて解決し、Eventhouse データベースの一貫性と信頼性を維持することができます。

エンティティ図を使用できるシナリオは何ですか?

このセクションでは、KQL データベースでエンティティ ダイアグラム ビューを使用できるさまざまなシナリオについて説明します。

依存関係を事前に管理する

テーブルや関数などのエンティティ間の依存関係の管理は、系列によって簡単になります。 たとえば、テーブルの名前を変更したり、そのスキーマを変更したりすると、KQL クエリ内でそのテーブルに依存する関数をすぐに識別できます。 このプロアクティブなアプローチは、予期しない問題を回避し、データベース構造をシームレスに更新するのに役立ちます。

具体化されたビューとソース テーブルの間のリレーションシップをトレースする

エンティティ図を使用すると、具体化されたビューとその基になるソース テーブルの間のリレーションシップをトレースできます。 これにより、元のデータ ソースを簡単に識別できるため、データ フローをより効果的に追跡およびトラブルシューティングできます。

要素と対話し、動作を行う

グラフ内の任意の要素を選択すると、関連する項目が強調表示されますが、グラフの残りの部分は淡色表示され、特定のリレーションシップに集中しやすくなります。 テーブルと外部テーブルの場合、省略記号 [...] では、テーブルのクエリ、テーブルに基づく Power BI レポートの作成など、他のオプションを選択できます。

勤務記録取り込みの追跡

エンティティ図を使用すると、各テーブルと具体化されたビューに取り込まれたレコードの数を追跡できます。 データ フローのこの明確なビューは、インジェストのサイズとボリュームを維持し、データベースがデータを正しく処理するのに役立ちます。

関連コンテンツ

• ワークスペースの履歴