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.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/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 |
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.
Par 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 | +----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+