Visualizzazione PROPERTY_GRAPHS

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

Autorizzazioni obbligatorie

Per eseguire query sulla visualizzazione INFORMATION_SCHEMA.PROPERTY_GRAPHS, chiedi all'amministratore di concederti uno dei seguenti ruoli IAM predefiniti:

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

Schema

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

La vista INFORMATION_SCHEMA.PROPERTY_GRAPHS ha lo schema seguente:

Nome colonna Tipo di dati Valore
property_graph_catalog STRING Il nome del progetto che contiene il set di dati in cui è definito il property graph.
property_graph_schema STRING Il nome del set di dati che contiene il grafico delle proprietà.
property_graph_name STRING Il nome del grafico delle proprietà.
property_graph_metadata_json STRING La rappresentazione JSON della definizione del grafico delle proprietà. Questa rappresentazione contiene informazioni sul grafico, come nodi, archi, etichette, proprietà, timestamp di creazione e timestamp di modifica.
ddl STRING Un'istruzione DDL che può essere utilizzata per creare il grafico delle 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 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ù, consulta la sezione Sintassi. La tabella seguente spiega gli ambiti di regione e risorsa 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 Google Cloud progetto. 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 maggiori informazioni, 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)                                     |
|                     | ...                                            | ...                                                  |
+---------------------+------------------------------------------------+------------------------------------------------------+