Knowledge Catalog（以前の Dataplex Universal Catalog）は、データアセット間の潜在的なリンクを検出し、関連データを検出して関係の性質を把握するのに役立ちます。
始める前に
データアセット間の関係を表示する前に、必要なロールが付与されていることを確認してください。
必要なロール
Knowledge Catalog でデータアセット間の関係を表示するために、Knowledge Catalog 固有の IAM ロールは必要ありません。Knowledge Catalog は、アセットが存在するソースシステム（BigQuery など）の既存の権限を使用して、関係を表示できるかどうかを判断します。たとえば、BigQuery テーブルを含む関係を表示するには、bigquery.tables.get 権限が必要です。
ソースシステムでアセットを表示する権限がない場合、そのアセットに関連するすべての関係が Knowledge Catalog の関係グラフで非表示になります。これにより、関係の可視性が、ソースシステムで確立されたセキュリティ境界と権限に準拠します。
データのリレーションシップについて
データ関係は、データアセットの接続方法を示します。たとえば、顧客データを含むテーブルを見つけた場合、そのリレーションシップから、注文やサポート チケットを一覧表示する関連テーブルを特定できます。また、リレーションシップは構造ガイドとして機能し、大規模言語モデルに不可欠なコンテキストを提供します。その結果、AI はより正確な回答を生成し、特定の情報を取得するための正確なクエリを作成します。
Knowledge Catalog は、データアセット間の一般的な関係を自動的に検出して保存します。リレーションシップ データは、次のようなさまざまなソースから取得されます。
- 履歴クエリログ Knowledge Catalog。クエリ履歴を継続的に分析して、テーブル間の潜在的な
JOINパターンを検出します。 - データ分析情報は、大規模言語モデルを使用してスキーマ属性とデータの重複を分析し、データ間の関係をオンデマンドで提案します。
サポートされているデータアセット
BigQuery のテーブルとビューのデータ関係を表示できます。
データ関係を表示する
BigQuery テーブルとビューのデータ関係を表示するには、Google Cloud コンソールまたは Dataplex API を使用します。
Console
BigQuery のテーブルのデータ関係を表示する手順は次のとおりです。
Google Cloud コンソールで、Knowledge Catalog の [検索] ページに移動します。
関係を表示する BigQuery テーブルを検索します。
検索結果で、表をクリックしてエントリページを開きます。
[関係] タブには、関係と次の情報が表示されます。
- ターゲット: 接続されたデータアセットの名前。
- 関係: アセットのリンクに使用される特定の列。
- タイプ: リンクの性質。例:
JOIN - Origin: 関係の送信元。たとえば、クエリ履歴などです。
- アクション: アセット間のリンクを検出するために使用できるサンプルクエリ。
REST
検出された関係は、Knowledge Catalog の 2 つのデータアセット（エントリ）間の関係を確立する EntryLinks として Knowledge Catalog に保存されます。結合された列や関係のソースなど、関係に関する詳細は EntryLinks のアスペクトとして保存されます。
データ関係を表示するには、次の方法を使用します。
LookupEntryLinksは、特定のデータ エントリをソースまたはターゲットとして参照するすべてのEntryLinksを取得し、特定のエントリに関連付けられた関係の完全なセットを返します。LookupContextは、コンテキスト メタデータを使用して AI エージェントをグラウンディングするための単一のエンドポイントを提供します。関連するデータアセットを含む、簡潔で事前フォーマットされたメタデータのパッケージを返します。
ロケーション
データ関係は、すべての BigQuery ロケーションで使用できます。
制限事項
- クエリログからの関係の自動検出は、BigQuery テーブルとビューでのみ使用できます。
- Knowledge Catalog はクエリ履歴のサンプルを分析して関係を特定します。つまり、一部のクエリではリンクが検出されない可能性があります。
- クエリの実行後、関係の検出に最大 48 時間かかることがあります。