Vue SCHEMATA_LINKS

La vue INFORMATION_SCHEMA.SCHEMATA_LINKS contient une ligne pour chaque ensemble de données associé partagé à l'aide du partage BigQuery. Cette vue contient également des ressources individuelles, telles que des tables ou des vues, dans un projet partagé à l'aide de data clean rooms. Cette vue affiche une ligne pour chaque ressource individuelle de l'ensemble de données associé.

Autorisation requise

Pour interroger la vue INFORMATION_SCHEMA.SCHEMATA_LINKS, vous devez disposer de l'autorisation IAM (Identity and Access Management) bigquery.datasets.get au niveau du projet.

Chacun des rôles IAM prédéfinis suivants inclut les autorisations dont vous avez besoin pour interroger la vue INFORMATION_SCHEMA.SCHEMATA_LINKS :

  • roles/bigquery.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer

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

Schéma

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

Nom de la colonne Type de données Valeur
catalog_name STRING Nom du projet qui contient l'ensemble de données source.
schema_name STRING Nom de l'ensemble de données source. Le nom de l'ensemble de données est également identifié comme datasetId.
linked_schema_catalog_number STRING Numéro du projet contenant l'ensemble de données associé.
linked_schema_catalog_name STRING Nom du projet contenant l'ensemble de données associé.
linked_schema_name STRING Nom de l'ensemble de données associé. Le nom de l'ensemble de données est également identifié comme datasetId.
linked_schema_creation_time TIMESTAMP Date et heure de création de l'ensemble de données associé.
linked_schema_org_display_name STRING Nom à afficher de l'organisation dans laquelle l'ensemble de données associé est créé.
shared_asset_id STRING ID du composant partagé à l'aide de data clean rooms. Cette valeur est null si link_type est défini sur REGULAR.
link_type STRING Type de l'ensemble de données associé. Les valeurs possibles sont REGULAR ou DCR (data clean rooms).

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un qualificatif de région. Si vous ne spécifiez pas de qualificatif de région, les métadonnées sont extraites de la région US. Le tableau suivant explique le champ d'application de la région pour cette vue :

Nom de la vue Champ d'application de la ressource Champ d'application de la région
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA_LINKS Niveau Projet Région US
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_LINKS Niveau Projet REGION
Remplacez l'élément suivant :
  • PROJECT_ID (facultatif) : ID de votre projet Trusted Cloud . Si non spécifié, le projet par défaut est utilisé.
  • REGION : tout nom de région d'ensemble de données. Par exemple, `region-us`.

Exemples

Cette section répertorie des exemples servant à interroger la vue INFORMATION_SCHEMA.SCHEMATA_LINKS.

Exemple : Répertorier tous les ensembles de données associés dans un autre projet

L'exemple suivant répertorie tous les ensembles de données associés dans un autre projet nommé otherproject dans la région multirégionale EU :

SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

Le résultat renvoyé ressemble à ceci : Certaines colonnes sont omises pour simplifier la sortie.

+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    catalog_name    |  schema_name    | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name | linked_schema_creation_time | shared_asset_id | link_type |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|  otherproject      | source_dataset  | subscriptioproject1        |                974999999291  | linked_dataset     |  subscriptionorg1              |         2025-08-07 05:02:27 | NULL            | REGULAR   |
|  otherproject      | source_dataset1 | subscriptionproject2       |                974999999292  | test_dcr           |  subscriptionorg2              |         2025-08-07 10:08:50 | test_table      | DCR       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+

Exemple : Répertorier tous les ensembles de données associés par un ensemble de données partagé

L'exemple suivant répertorie tous les ensembles de données associés par un ensemble de données partagé nommé sharedataset dans l'emplacement multirégional US :

SELECT * FROM INFORMATION_SCHEMA.SCHEMATA_LINKS WHERE schema_name = 'sharedataset';

Le résultat renvoyé ressemble à ceci : Certaines colonnes sont omises pour simplifier la sortie.


+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    catalog_name     |  schema_name   | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name | linked_schema_creation_time | shared_asset_id | link_type |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|  myproject          | sharedataset   | subscriptionproject1       |                974999999291  | linked_dataset     |  subscriptionorg1              |         2025-08-07 05:02:27 | NULL            | REGULAR   |
|  myproject          | sharedataset   | subscriptionproject2       |                974999999292  | test_dcr           |  subscriptionorg2              |         2025-08-07 10:08:50 | test_table      | DCR       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+

Exemple : Lister toutes les ressources partagées à l'aide d'une data clean room

L'exemple suivant répertorie toutes les ressources individuelles, telles que les tables ou les vues, qui sont partagées à l'aide d'une data clean room provenant d'un autre projet nommé otherproject dans la multirégion EU :

SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS where link_type='DCR';

Le résultat renvoyé ressemble à ceci : Certaines colonnes sont omises pour simplifier la sortie.

+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    catalog_name     |  schema_name   | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name | linked_schema_creation_time | shared_asset_id | link_type |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|  otherproject       | sharedataset1  | subscriptionproject1       |                 974999999291 | test_dcr1          |  subscriptionorg1              |         2025-08-07 05:02:27 | test_view       | DCR       |
|  otherproject       | sharedataset2  | subscriptionproject2       |                 974999999292 | test_dcr2          |  subscriptionorg2              |         2025-08-07 10:08:50 | test_table      | DCR       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+