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.

Remarque : Vous devez spécifier l'emplacement pour interroger les vues INFORMATION_SCHEMA. L'emplacement d'exécution de la requête doit correspondre à la région de la vue INFORMATION_SCHEMA.

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