Vista PROPERTY_GRAPHS

La vista INFORMATION_SCHEMA.PROPERTY_GRAPHS contiene una riga per ogni grafo di proprietà nel set di dati o nella regione che specifichi.

Autorizzazioni obbligatorie

Per ottenere le autorizzazioni necessarie per eseguire query sulla vista INFORMATION_SCHEMA.PROPERTY_GRAPHS, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per eseguire query sulla vista INFORMATION_SCHEMA.PROPERTY_GRAPHS. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per eseguire query sulla vista INFORMATION_SCHEMA.PROPERTY_GRAPHS sono necessarie le seguenti autorizzazioni:

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

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più sulle autorizzazioni di BigQuery, consulta Controllo dell'accesso con IAM.

Schema

Quando esegui una query sulla vista INFORMATION_SCHEMA.PROPERTY_GRAPHS, i risultati della query contengono una riga per ogni grafo di proprietà nell'ambito della risorsa che specifichi.

La vista INFORMATION_SCHEMA.PROPERTY_GRAPHS ha il seguente schema:

Nome colonna Tipo di dati Valore
property_graph_catalog STRING Il nome del progetto che contiene il set di dati in cui è definito il grafo di proprietà.
property_graph_schema STRING Il nome del set di dati che contiene il grafo di proprietà.
property_graph_name STRING Il nome del grafo di proprietà.
property_graph_metadata_json STRING La rappresentazione JSON della definizione del grafo di proprietà. Questa rappresentazione contiene informazioni sul grafo, come nodi, bordi, etichette, proprietà, timestamp di creazione e timestamp di modifica.
ddl STRING Un'istruzione DDL che può essere utilizzata per creare il grafo di proprietà.

Ambito e sintassi

Le query su questa vista devono includere un qualificatore di set di dati o di regione. Per le query con un qualificatore di set di dati, devi disporre delle autorizzazioni per il set di dati. Per le query con un qualificatore di regione, devi disporre delle autorizzazioni per il progetto. Per saperne di più, vedi Sintassi. La tabella seguente spiega gli ambiti di regione e risorsa per questa vista:

Nome vista Ambito risorsa Ambito regionale
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.PROPERTY_GRAPHS Livello progetto REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.PROPERTY_GRAPHS Livello set di dati Posizione del set di dati
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo Google Cloud progetto. Se non specificato, viene utilizzato il progetto predefinito.
  • REGION: il nome di una regione del set di dati. Ad esempio, `region-us`.
  • DATASET_ID: l'ID del set di dati. Per saperne di più, vedi Qualificatore del set di dati.

Esempio

L'esempio seguente recupera le colonne property_graph_name, property_graph_metadata_json e ddl dalla vista INFORMATION_SCHEMA.PROPERTY_GRAPHS:

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

Il risultato è simile al seguente:

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