Visualizzazione PROPERTY_GRAPHS

La vista INFORMATION_SCHEMA.PROPERTY_GRAPHS contiene una riga per ogni grafo 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 grafico nell'ambito delle risorse 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.
property_graph_schema STRING Il nome del set di dati che contiene il grafico.
property_graph_name STRING Il nome del grafico.
property_graph_metadata_json STRING La rappresentazione JSON della definizione del grafico. Questa rappresentazione contiene informazioni sul grafo, come nodi, archi, etichette, proprietà, timestamp di creazione e timestamp di modifica.
ddl STRING Un'istruzione DDL che può essere utilizzata per creare il grafo.

Ambito e sintassi

Le query su questa vista devono includere un qualificatore del set di dati o della regione. Per le query con un qualificatore del 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 illustra gli ambiti delle regioni e delle risorse per questa visualizzazione:

Nome vista Ambito risorsa Ambito della regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.PROPERTY_GRAPHS Livello progetto REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.PROPERTY_GRAPHS Livello del set di dati Posizione del set di dati
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo progetto Google Cloud . Se non specificato, viene utilizzato il progetto predefinito.
  • REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.
  • DATASET_ID: l'ID del set di dati. Per saperne di più, consulta 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)                                     |
|                     | ...                                            | ...                                                  |
+---------------------+------------------------------------------------+------------------------------------------------------+