Visualização PROPERTY_GRAPHS

A visualização INFORMATION_SCHEMA.PROPERTY_GRAPHS contém uma linha para cada gráfico de propriedade no conjunto de dados ou na região que você especificar.

Permissões necessárias

Para consultar a visualização INFORMATION_SCHEMA.PROPERTY_GRAPHS, peça ao administrador para conceder a você um dos seguintes papéis predefinidos do IAM:

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

Esquema

Quando você consulta a visualização INFORMATION_SCHEMA.PROPERTY_GRAPHS, os resultados da consulta contêm uma linha para cada gráfico de propriedade no escopo do recurso especificado.

A visualização INFORMATION_SCHEMA.PROPERTY_GRAPHS tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
property_graph_catalog STRING O nome do projeto que contém o conjunto de dados em que o gráfico de propriedade está definido.
property_graph_schema STRING O nome do conjunto de dados que contém o gráfico de propriedade.
property_graph_name STRING O nome do gráfico de propriedade.
property_graph_metadata_json STRING A representação JSON da definição do gráfico de propriedade. Essa representação contém informações sobre o gráfico, como nós, arestas, rótulos, propriedades, carimbo de data/hora de criação e carimbos de data/hora de modificação.
ddl STRING Uma instrução DDL que pode ser usada para criar o gráfico de propriedade.

Escopo e sintaxe

As consultas nessa visualização precisam incluir um conjunto de dados ou um qualificador de região. Para consultas com um qualificador de conjunto de dados, é preciso ter permissões para o conjunto de dados. Para consultas com um qualificador de região, é preciso ter permissões para o projeto. Para mais informações, consulte Sintaxe. A tabela a seguir explica os escopos de região e recurso dessa visualização:

Nome da visualização Escopo do recurso Escopo da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.PROPERTY_GRAPHS Nível do projeto REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.PROPERTY_GRAPHS Nível do conjunto de dados Local do conjunto de dados
Substitua:
  • Opcional: PROJECT_ID: o ID do seu Google Cloud projeto. Se não for especificado, o projeto padrão será usado.
  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.
  • DATASET_ID: ID do conjunto de dados. Para mais informações, consulte Qualificador de conjunto de dados.

Exemplo

O exemplo a seguir recupera as colunas property_graph_name, property_graph_metadata_json e ddl da visualização INFORMATION_SCHEMA.PROPERTY_GRAPHS:

SELECT
  property_graph_name, property_graph_metadata_json, ddl
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROPERTY_GRAPHS;

O resultado será semelhante ao seguinte:

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