PROPERTY_GRAPHS 檢視畫面

INFORMATION_SCHEMA.PROPERTY_GRAPHS 檢視表會針對您指定的資料集或區域中的每個屬性圖形，分別列出一個相對應的資料列。

所需權限

如要查詢 INFORMATION_SCHEMA.PROPERTY_GRAPHS 檢視畫面，請要求管理員授予您下列其中一個預先定義的 IAM 角色：

  • roles/bigquery.metadataViewer
  • roles/bigquery.dataViewer
  • roles/bigquery.admin

結構定義

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