Vista PROPERTY_GRAPHS

La vista INFORMATION_SCHEMA.PROPERTY_GRAPHS contiene una fila para cada gráfico de propiedades en el conjunto de datos o la región que especifiques.

Permisos necesarios

Para consultar la vista INFORMATION_SCHEMA.PROPERTY_GRAPHS, pídele a tu administrador que te otorgue uno de los siguientes roles de IAM predefinidos:

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

Esquema

Cuando consultas la vista INFORMATION_SCHEMA.PROPERTY_GRAPHS, los resultados de la consulta contienen una fila por cada gráfico de propiedades en el permiso del recurso que especifiques.

La vista INFORMATION_SCHEMA.PROPERTY_GRAPHS tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
property_graph_catalog STRING El nombre del proyecto que contiene el conjunto de datos en el que se define el gráfico de propiedades.
property_graph_schema STRING El nombre del conjunto de datos que contiene el gráfico de propiedades.
property_graph_name STRING El nombre del gráfico de propiedades.
property_graph_metadata_json STRING La representación JSON de la definición del gráfico de propiedades. Esta representación contiene información sobre el gráfico, como sus nodos, bordes, etiquetas, propiedades, marca de tiempo de creación y marcas de tiempo de modificación.
ddl STRING Una instrucción DDL que se puede usar para crear el gráfico de propiedades.

Permiso y sintaxis

Las consultas realizadas a esta vista deben incluir un conjunto de datos o un calificador de región. Para consultas con un calificador de conjunto de datos, debes tener permisos para el conjunto de datos. Para consultas con un calificador de región, debes tener permisos para el proyecto. Para obtener más información, consulta Sintaxis. En la siguiente tabla, se explican los permisos de la región y los recursos para esta vista:

Nombre de la vista Permiso del recurso Permiso de la región
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.PROPERTY_GRAPHS Nivel de proyecto REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.PROPERTY_GRAPHS Nivel de conjunto de datos Ubicación del conjunto de datos
Reemplaza lo siguiente:
  • Opcional: PROJECT_ID: Es el ID de tu Google Cloud proyecto. Si no se especifica, se usa el proyecto predeterminado.
  • REGION: Cualquier nombre de región del conjunto de datos. Por ejemplo, `region-us`.
  • DATASET_ID: Es el ID del conjunto de datos. Para obtener más información, consulta Calificador de conjunto de datos.

Ejemplo

En el siguiente ejemplo, se recuperan las columnas property_graph_name, property_graph_metadata_json y ddl de la vista INFORMATION_SCHEMA.PROPERTY_GRAPHS:

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

El resultado es similar al siguiente:

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