Vue PROPERTY_GRAPHS

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

Autorisations requises

Pour obtenir les autorisations nécessaires pour interroger la vue INFORMATION_SCHEMA.PROPERTY_GRAPHS, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour interroger la vue INFORMATION_SCHEMA.PROPERTY_GRAPHS. Pour afficher les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour interroger la vue INFORMATION_SCHEMA.PROPERTY_GRAPHS :

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

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour plus d'informations sur les autorisations BigQuery, consultez la page Contrôle des accès avec IAM.

Schéma

Lorsque vous interrogez la vue INFORMATION_SCHEMA.PROPERTY_GRAPHS, les résultats de la requête contiennent une ligne pour chaque graphe de propriétés 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 graphe de propriétés est défini.
property_graph_schema STRING Nom de l'ensemble de données contenant le graphe 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 graphe de propriétés. Cette représentation contient des informations sur le graphe, telles que ses nœuds, arêtes, libellés, propriétés, code temporel de création et codes temporels de modification.
ddl STRING Instruction LDD pouvant être utilisée pour créer le graphe de propriétés.

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 :
  • (facultatif) PROJECT_ID : ID de votre Google Cloud projet. 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)                                     |
|                     | ...                                            | ...                                                  |
+---------------------+------------------------------------------------+------------------------------------------------------+