Vue PROPERTY_GRAPHS

La vue INFORMATION_SCHEMA.PROPERTY_GRAPHS contient une ligne pour chaque graphique de propriétés dans l'ensemble de données ou la région que vous spécifiez.

Autorisations requises

Pour interroger la vue INFORMATION_SCHEMA.PROPERTY_GRAPHS, demandez à votre administrateur de vous accorder l'un des rôles IAM prédéfinis suivants :

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

Schéma

Lorsque vous interrogez la vue INFORMATION_SCHEMA.PROPERTY_GRAPHS, les résultats de la requête contiennent une ligne pour chaque graphique de propriété dans le champ d'application de la ressource que vous spécifiez.

La vue INFORMATION_SCHEMA.PROPERTY_GRAPHS présente le schéma suivant :

Nom de la colonne Type de données Valeur
property_graph_catalog STRING Nom du projet contenant l'ensemble de données dans lequel le graphique de propriétés est défini.
property_graph_schema STRING Nom de l'ensemble de données contenant le graphique de propriétés.
property_graph_name STRING Nom du graphe de propriétés.
property_graph_metadata_json STRING Représentation JSON de la définition du graphique de propriétés. Cette représentation contient des informations sur le graphique, telles que ses nœuds, ses arêtes, ses libellés, ses propriétés, son code temporel de création et ses codes temporels de modification.
ddl STRING Instruction LDD pouvant être utilisée pour créer le graphique de propriété.

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un ensemble de données ou un qualificatif de région. Pour les requêtes avec un qualificatif d'ensemble de données, vous devez disposer d'autorisations pour l'ensemble de données. Pour les requêtes avec un qualificatif de région, vous devez disposer des autorisations nécessaires sur le projet. Pour en savoir plus, consultez la section Syntaxe. Le tableau suivant explique la portée des régions et des ressources pour cette vue :

Nom de la vue Champ d'application de la ressource Champ d'application de la région
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.PROPERTY_GRAPHS Niveau Projet REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.PROPERTY_GRAPHS Niveau de l'ensemble de données Emplacement de l'ensemble de données
Remplacez l'élément suivant :
  • PROJECT_ID (facultatif) : ID de votre projet Google Cloud . Si non spécifié, le projet par défaut est utilisé.
  • REGION : tout nom de région d'ensemble de données. Exemple : `region-us`.
  • DATASET_ID : ID de votre ensemble de données. Pour en savoir plus, consultez la section Qualificatif d'ensemble de données.

Exemple

L'exemple suivant récupère les colonnes property_graph_name, property_graph_metadata_json et ddl de la vue INFORMATION_SCHEMA.PROPERTY_GRAPHS :

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

Le résultat ressemble à ce qui suit :

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