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：專案 ID。 Google Cloud 如未指定，系統會使用預設專案。
  • 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)                                     |
|                     | ...                                            | ...                                                  |
+---------------------+------------------------------------------------+------------------------------------------------------+