Vue SCHEMATA_LINKS

La vue INFORMATION_SCHEMA.SCHEMATA_LINKS contient une ligne pour chaque ensemble de données associé. Un ensemble de données associé fournit un lien vers un ensemble de données partagé hébergé dans un projet auquel l'utilisateur actuel a accès.

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éé.

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 les éléments suivants :

  • Facultatif : PROJECT_ID : 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

Examples

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 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 |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| otherproject   | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg2               |
| otherproject   | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg2               |
| otherproject   | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg3               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

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 |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | sharedataset| subscriptionproject1       |                 674999999291 | subscriptionld1    | subscriptionorg1               |
| myproject      | sharedataset| subscriptionproject2       |                 774999999292 | subscriptionld2    | subscriptionorg3               |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+