PROPERTY_GRAPHS 檢視表

INFORMATION_SCHEMA.PROPERTY_GRAPHS 檢視畫面中，您指定的資料集或區域中的每個圖表都有一列。

所需權限

如要取得查詢 INFORMATION_SCHEMA.PROPERTY_GRAPHS 檢視表所需的權限，請要求管理員在專案中授予您下列 IAM 角色：

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這些預先定義的角色具備查詢 INFORMATION_SCHEMA.PROPERTY_GRAPHS 檢視表所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

必須具備下列權限，才能查詢 INFORMATION_SCHEMA.PROPERTY_GRAPHS 檢視表：

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

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

如要進一步瞭解 BigQuery 權限，請參閱「使用 IAM 控管存取權」。

結構定義

查詢 INFORMATION_SCHEMA.PROPERTY_GRAPHS 檢視表時，查詢結果會針對您指定的資源範圍內每個圖表，顯示一列資料。

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