Présentation de BigQuery INFORMATION_SCHEMA

Les vues BigQuery INFORMATION_SCHEMA sont des vues en lecture seule définies par le système qui fournissent des informations de métadonnées sur vos objets BigQuery. Le tableau suivant répertorie toutes les vues INFORMATION_SCHEMA que vous pouvez interroger pour récupérer des informations de métadonnées :

Resource type	Vue INFORMATION_SCHEMA
Contrôle des accès	`OBJECT_PRIVILEGES`
Réservations d'informatique décisionnelle	`BI_CAPACITIES` `BI_CAPACITY_CHANGES`
Options de configuration	`EFFECTIVE_PROJECT_OPTIONS` `ORGANIZATION_OPTIONS` `PROJECT_OPTIONS`
Ensembles de données	`SCHEMATA`
Options des ensembles de données	`SCHEMATA_OPTIONS`
Métadonnées d'index	`SEARCH_INDEXES` `SEARCH_INDEXES_COLUMNS`
Métadonnées de tâche	`JOBS_BY_PROJECT^†` `JOBS_BY_USER` `JOBS_BY_FOLDER` `JOBS_BY_ORGANIZATION`
Métadonnées de tâche par tranche horaire	`JOBS_TIMELINE_BY_PROJECT^†` `JOBS_TIMELINE_BY_USER` `JOBS_TIMELINE_BY_FOLDER` `JOBS_TIMELINE_BY_ORGANIZATION`
Métadonnées de réservation	`RESERVATIONS_BY_PROJECT^†` `RESERVATION_CHANGES_BY_PROJECT^†` `RESERVATIONS_TIMELINE_BY_PROJECT^†` `ASSIGNMENTS_BY_PROJECT^†` `ASSIGNMENT_CHANGES_BY_PROJECT^†` `CAPACITY_COMMITMENTS_BY_PROJECT^†` `CAPACITY_COMMITMENT_CHANGES_BY_PROJECT^†`
Routines	`ROUTINES`
Options de routine	`ROUTINE_OPTIONS`
Paramètres de routine	`PARAMETERS`
Métadonnées de session	`SESSIONS_BY_PROJECT^†` `SESSIONS_BY_USER`
Flux de données	`STREAMING_TIMELINE_BY_PROJECT^†` `STREAMING_TIMELINE_BY_FOLDER` `STREAMING_TIMELINE_BY_ORGANIZATION`
Métadonnées de table	`TABLES` `TABLE_OPTIONS`
Colonnes de table	`COLUMNS` `COLUMN_FIELD_PATHS`
Partitions de table	`PARTITIONS`
Instantanés de table	`TABLE_SNAPSHOT`
Utilisation du stockage de table (actuelle)	`TABLE_STORAGE_BY_PROJECT^†` `TABLE_STORAGE_BY_ORGANIZATION`
Utilisation de l'espace de stockage d'une table au fil du temps	`TABLE_STORAGE_TIMELINE_BY_PROJECT^†` `TABLE_STORAGE_TIMELINE_BY_ORGANIZATION`
Vues	`VIEWS`

^† Pour les vues *BY_PROJECT, le suffixe BY_PROJECT est facultatif. Par exemple, l'interrogation de INFORMATION_SCHEMA.JOBS_BY_PROJECT et de INFORMATION_SCHEMA.JOBS renvoie les mêmes résultats.

Tarifs

Pour les projets appliquant la tarification à la demande, les requêtes exécutées sur les vues INFORMATION_SCHEMA engendrent des frais de traitement de données de 10 Mo minimum, même si le nombre d'octets traités par la requête est inférieur à cette valeur. Il s'agit du montant minimal de facturation pour les requêtes à la demande. Pour en savoir plus, consultez la section Tarifs à la demande.

Pour les projets qui utilisent la tarification forfaitaire, les requêtes portant sur des vues et des tables INFORMATION_SCHEMA consomment les emplacements BigQuery achetés. Pour en savoir plus, consultez la section Tarifs forfaitaires.

Étant donné que les requêtes INFORMATION_SCHEMA ne sont pas mises en cache, des frais vous sont facturés chaque fois que vous exécutez une requête INFORMATION_SCHEMA, même si le texte de la requête est identique à chaque exécution.

Vous ne payez pas de frais de stockage pour les vues INFORMATION_SCHEMA.

Syntaxe

Une vue INFORMATION_SCHEMA peut nécessiter d'être qualifiée avec un ensemble de données ou une région.

Qualificatif d'ensemble de données

Lorsqu'un qualificatif d'ensemble de données est présent, il limite les résultats à l'ensemble de données spécifié. Exemple :

-- Returns metadata for tables in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLES;

Les vues INFORMATION_SCHEMA suivantes sont compatibles avec les qualificatifs d'ensemble de données :

COLUMNS
COLUMN_FIELD_PATHS
PARAMETERS
PARTITIONS
ROUTINES
ROUTINE_OPTIONS
TABLES
TABLE_OPTIONS
VIEWS

Qualificatif de région

Les qualificatifs de région sont représentés à l'aide d'une syntaxe region-REGION. Tout nom d'emplacement d'ensemble de données peut être utilisé pour REGION. Par exemple, les qualificatifs de région suivants sont valides :

region-us
region-asia-east2
region-europe-north1

Lorsqu'un qualificatif de région est présent, il limite les résultats à l'emplacement spécifié. Par exemple, la requête suivante renvoie les métadonnées de tous les ensembles de données d'un projet dans l'emplacement multirégional US :

-- Returns metadata for all datasets in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.SCHEMATA;

Les vues INFORMATION_SCHEMA suivantes ne sont pas compatibles avec les qualificatifs de région :

Si aucun qualificatif de région ni aucun qualificatif d'ensemble de données ne sont spécifiés, une erreur est renvoyée.

Qualificatif de projet

Lorsqu'un qualificatif de projet est présent, il limite les résultats au projet spécifié. Exemple :

-- Returns metadata for the specified project and region.
SELECT * FROM myProject.`region-us`.INFORMATION_SCHEMA.TABLES;

-- Returns metadata for the specified project and dataset.
SELECT * FROM myProject.myDataset.INFORMATION_SCHEMA.TABLES;

Toutes les vues INFORMATION_SCHEMA sont compatibles avec les qualificatifs de projet. Si un qualificatif de projet n'est pas spécifié, la vue est définie par défaut sur le projet dans lequel la requête est exécutée.

La spécification d'un qualificatif de projet pour les vues au niveau de l'organisation (par exemple, STREAMING_TIMELINE_BY_ORGANIZATION, TABLE_STORAGE_TIMELINE_BY_ORGANIZATION) n'a aucun impact sur les résultats.

Limites

La syntaxe des requêtes BigQuery INFORMATION_SCHEMA doit être en SQL standard. INFORMATION_SCHEMA n'est pas compatible avec l'ancien SQL.
Les résultats de requêtes INFORMATION_SCHEMA ne sont pas mis en cache.
Les vues INFORMATION_SCHEMA ne peuvent pas être utilisées dans des instructions LDD.