Vue SCHEMATA
La vue INFORMATION_SCHEMA.SCHEMATA
fournit des informations sur les ensembles de données d'un projet ou d'une région. La vue renvoie une ligne pour chaque ensemble de données.
Avant de commencer
Pour interroger la vue SCHEMATA
pour les métadonnées de l'ensemble de données, vous devez disposer de l'autorisation Identity and Access Management (IAM) bigquery.datasets.get
au niveau du projet.
Chacun des rôles IAM prédéfinis suivants inclut les autorisations dont vous avez besoin pour obtenir la vue SCHEMATA
:
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
Lorsque vous interrogez la vueINFORMATION_SCHEMA.SCHEMATA
, les résultats des requêtes contiennent une ligne pour chaque ensemble de données du projet spécifié.
La vue INFORMATION_SCHEMA.SCHEMATA
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 |
SCHEMA_NAME |
STRING |
Nom de l'ensemble de données (également appelé datasetId ) |
SCHEMA_OWNER |
STRING |
La valeur est toujours NULL |
CREATION_TIME |
TIMESTAMP |
Date/Heure de création de l'ensemble de données |
LAST_MODIFIED_TIME |
TIMESTAMP |
Date/Heure de la dernière modification de l'ensemble de données |
LOCATION |
STRING |
Emplacement géographique de l'ensemble de données |
DDL |
STRING |
Instruction LDD CREATE SCHEMA pouvant être utilisée pour créer l'ensemble de données |
DEFAULT_COLLATION_NAME |
STRING |
Nom de la spécification de classement par défaut, le cas échéant. Dans le cas contraire, cette valeur est définie sur NULL .
|
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 |
Niveau Projet | Région US |
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA |
Niveau Projet | REGION |
- Facultatif :
PROJECT_ID
: ID de votre projet Google Cloud. Si non spécifié, le projet par défaut est utilisé.
REGION
: nom de la région de l'ensemble de données.
Exemple : region-us
.
Exemple
-- Returns metadata for datasets in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.SCHEMATA;
Exemple
Pour exécuter la requête sur un projet autre que celui par défaut, ajoutez l'ID du projet à l'ensemble de données, en respectant le format suivant :
`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA
`myproject`.INFORMATION_SCHEMA.SCHEMATA
.
SELECT * EXCEPT (schema_owner) FROM INFORMATION_SCHEMA.SCHEMATA;
Le résultat ressemble à ce qui suit. Pour des raisons de lisibilité, certaines colonnes sont exclues des résultats.
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+ | catalog_name | schema_name | creation_time | last_modified_time | location | ddl | +----------------+---------------+---------------------+---------------------+------------+------------------------------------------+ | myproject | mydataset1 | 2018-11-07 19:50:24 | 2018-11-07 19:50:24 | US | CREATE SCHEMA `myproject.mydataset1` | | | | | | | OPTIONS( | | | | | | | location="us" | | | | | | | ); | +----------------+---------------+---------------------+---------------------+------------+------------------------------------------+ | myproject | mydataset2 | 2018-07-16 04:24:22 | 2018-07-16 04:24:22 | US | CREATE SCHEMA `myproject.mydataset2` | | | | | | | OPTIONS( | | | | | | | default_partition_expiration_days=3.0, | | | | | | | location="us" | | | | | | | ); | +----------------+---------------+---------------------+---------------------+------------+------------------------------------------+ | myproject | mydataset3 | 2018-02-07 21:08:45 | 2018-05-01 23:32:53 | US | CREATE SCHEMA `myproject.mydataset3` | | | | | | | OPTIONS( | | | | | | | description="My dataset", | | | | | | | location="us" | | | | | | | ); | +----------------+---------------+---------------------+---------------------+------------+------------------------------------------+