Visualização PROPERTY_GRAPHS

A visualização INFORMATION_SCHEMA.PROPERTY_GRAPHS contém uma linha para cada gráfico de propriedades no conjunto de dados ou região especificada.

Permissões necessárias

Para receber as permissões necessárias para consultar a visualização INFORMATION_SCHEMA.PROPERTY_GRAPHS, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para consultar a visualização INFORMATION_SCHEMA.PROPERTY_GRAPHS. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para consultar a visualização INFORMATION_SCHEMA.PROPERTY_GRAPHS:

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

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para mais informações sobre as permissões do BigQuery, consulte Controle de acesso com o IAM.

Esquema

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

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 propriedades está definido.
property_graph_schema STRING O nome do conjunto de dados que contém o gráfico de propriedades.
property_graph_name STRING O nome do gráfico de propriedades.
property_graph_metadata_json STRING A representação JSON da definição do gráfico de propriedades. 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 propriedades.

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 projeto do Cloud de Confiance . 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)                                     |
|                     | ...                                            | ...                                                  |
+---------------------+------------------------------------------------+------------------------------------------------------+