PROPERTY_GRAPHS ビュー
INFORMATION_SCHEMA.PROPERTY_GRAPHS ビューには、指定したデータセットまたはリージョン内の
プロパティ グラフごとに 1 行が含まれます。
必要な権限
INFORMATION_SCHEMA.PROPERTY_GRAPHS ビューにクエリを実行するには、次のいずれかの IAM 事前定義ロールを付与するよう管理者に依頼してください。
roles/bigquery.metadataViewerroles/bigquery.dataViewerroles/bigquery.admin
スキーマ
INFORMATION_SCHEMA.PROPERTY_GRAPHS ビューにクエリを実行すると、指定したリソース スコープ内のプロパティ グラフごとに 1 行が表示されるクエリ結果が返されます。
INFORMATION_SCHEMA.PROPERTY_GRAPHS ビューのスキーマは次のとおりです。
| 列名 | データ型 | 値 |
|---|---|---|
property_graph_catalog |
STRING |
プロパティ グラフが定義されているデータセットを含むプロジェクトの名前。 |
property_graph_schema |
STRING |
プロパティ グラフを含むデータセットの名前。 |
property_graph_name |
STRING |
プロパティ グラフの名前。 |
property_graph_metadata_json |
STRING |
プロパティ グラフ定義の JSON 表現。この 表現には、グラフに関する情報(ノード、 エッジ、ラベル、プロパティ、作成タイムスタンプ、変更 タイムスタンプなど)が含まれます。 |
ddl |
STRING |
プロパティ グラフの作成に使用できる DDL ステートメント。 |
スコープと構文
このビューに対するクエリでは、データセット修飾子またはリージョン修飾子を指定する必要があります。データセット修飾子が指定されたクエリの場合は、データセットに対する権限が必要です。リージョン修飾子が指定されたクエリの場合は、プロジェクトに対する権限が必要です。詳細については、構文をご覧ください。次の表に、このビューのリージョン スコープとリソース スコープを示します。
| ビュー名 | リソース スコープ | リージョン スコープ |
|---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.PROPERTY_GRAPHS |
プロジェクト レベル | REGION |
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.PROPERTY_GRAPHS |
データセット レベル | データセットのロケーション |
-
省略可:
PROJECT_ID: Google Cloud プロジェクトの ID。指定しない場合は、デフォルトのプロジェクトが使用されます。 -
REGION: 任意のデータセット リージョン名。例:`region-us` -
DATASET_ID: データセットの ID。詳しくは、データセット修飾子をご覧ください。
例
次の例では、INFORMATION_SCHEMA.PROPERTY_GRAPHS ビューから property_graph_name 列、property_graph_metadata_json 列、ddl 列を取得します。
SELECT property_graph_name, property_graph_metadata_json, ddl FROM `region-REGION`.INFORMATION_SCHEMA.PROPERTY_GRAPHS;
次のような結果になります。
+---------------------+------------------------------------------------+------------------------------------------------------+
| property_graph_name | property_graph_metadata_json | ddl |
+---------------------+------------------------------------------------+------------------------------------------------------+
| FinGraph | {"creationTime":"2026-01-05T22:22:22.365394Z", | CREATE PROPERTY GRAPH `my_project.graph_db.FinGraph` |
| | "edgeTables":[{"dataSourceTable":{"datasetId": | NODE TABLES (`my_project.graph_db.Account` AS |
| | "graph_db","projectId":"my_project","tableId | Account KEY (id) |
| | ... | ... |
+---------------------+------------------------------------------------+------------------------------------------------------+