PROPERTY_GRAPHS 视图

INFORMATION_SCHEMA.PROPERTY_GRAPHS 视图中的每一行对应于您指定的数据集或区域中的每个属性图。

所需权限

如需获得查询 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 视图时，查询结果会针对您指定的资源范围内的每个属性图返回一行。

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