Vista PROPERTY_GRAPHS

La vista INFORMATION_SCHEMA.PROPERTY_GRAPHS contiene una fila para cada grafo de propiedad en el conjunto de datos o la región que especifiques.

Permisos necesarios

Para obtener los permisos que necesitas para consultar la vista INFORMATION_SCHEMA.PROPERTY_GRAPHS, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para consultar la vista INFORMATION_SCHEMA.PROPERTY_GRAPHS. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para consultar la vista INFORMATION_SCHEMA.PROPERTY_GRAPHS:

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

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.

Esquema

Cuando consultas la vista INFORMATION_SCHEMA.PROPERTY_GRAPHS, los resultados de la consulta contienen una fila por cada grafo de propiedad en el alcance del recurso que especificas.

La vista INFORMATION_SCHEMA.PROPERTY_GRAPHS tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
property_graph_catalog STRING Es el nombre del proyecto que contiene el conjunto de datos en el que se define el gráfico de propiedades.
property_graph_schema STRING Es el nombre del conjunto de datos que contiene el gráfico de propiedades.
property_graph_name STRING Es el nombre del gráfico de propiedades.
property_graph_metadata_json STRING Es 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, marcas de tiempo de creación y marcas de tiempo de modificación.
ddl STRING Es una declaració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 proyecto de Cloud de Confiance . 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)                                     |
|                     | ...                                            | ...                                                  |
+---------------------+------------------------------------------------+------------------------------------------------------+