PROPERTY_GRAPHS ビュー

INFORMATION_SCHEMA.PROPERTY_GRAPHS ビューには、指定したデータセットまたはリージョンのプロパティ グラフごとに 1 行が表示されます。

必要な権限

INFORMATION_SCHEMA.PROPERTY_GRAPHS ビューのクエリに必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

これらの事前定義ロールには、INFORMATION_SCHEMA.PROPERTY_GRAPHS ビューにクエリを実行するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

INFORMATION_SCHEMA.PROPERTY_GRAPHS ビューにクエリを実行するには、次の権限が必要です。

  • bigquery.propertyGraphs.get
  • bigquery.propertyGraphs.list

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

BigQuery の権限の詳細については、IAM でのアクセス制御をご覧ください。

スキーマ

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)                                     |
|                     | ...                                            | ...                                                  |
+---------------------+------------------------------------------------+------------------------------------------------------+