Vue TABLE_SNAPSHOTS
La vue INFORMATION_SCHEMA.TABLE_SNAPSHOTS contient des métadonnées relatives à vos instantanés de table. Pour en savoir plus, consultez la page Présentation des instantanés de table.
Autorisations requises
Pour interroger la vue INFORMATION_SCHEMA.TABLE_SNAPSHOTS, vous devez disposer de l'autorisation IAM (Identity and Access Management) bigquery.tables.list pour l'ensemble de données.
Le rôle prédéfini roles/bigquery.metadataViewer inclut l'autorisation requise.
Pour plus d'informations sur les autorisations BigQuery, consultez la page Contrôle des accès avec IAM.
Schéma
Lorsque vous interrogez la table INFORMATION_SCHEMA.TABLE_SNAPSHOTS, les résultats contiennent une ligne pour chaque instantané de table de l'ensemble de données ou de la région spécifié.
Le tableau INFORMATION_SCHEMA.TABLE_SNAPSHOTS présente le schéma suivant :
La table standard à partir de laquelle l'instantané de table a été pris est appelée table de base.
| Nom de la colonne | Type de données | Valeur |
|---|---|---|
table_catalog |
STRING |
Nom du projet contenant l'instantané de la table |
table_schema |
STRING |
Nom de l'ensemble de données contenant l'instantané de table |
table_name |
STRING |
Nom de l'instantané de table |
base_table_catalog |
STRING |
Nom du projet contenant la table de base |
base_table_schema |
STRING |
Nom de l'ensemble de données contenant la table de base |
base_table_name |
STRING |
Nom de la table de base |
snapshot_time |
TIMESTAMP |
Heure de création de l'instantané de table |
Champ d'application et syntaxe
Les requêtes exécutées sur cette vue doivent inclure un ensemble de données ou un qualificatif de région. Pour les requêtes avec un qualificatif d'ensemble de données, vous devez disposer d'autorisations pour l'ensemble de données. Pour les requêtes avec un qualificatif de région, vous devez disposer des autorisations nécessaires sur le projet. Pour en savoir plus, consultez la section Syntaxe. Le tableau suivant explique la portée des régions et des ressources pour cette vue :
| Nom de la vue | Champ d'application de la ressource | Champ d'application de la région |
|---|---|---|
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS |
Niveau Projet | REGION |
[`PROJECT_ID`.]DATASET_ID.INFORMATION_SCHEMA.TABLE_SNAPSHOTS |
Niveau de l'ensemble de données | Emplacement d'un ensemble de données |
- 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.DATASET_ID: ID de votre ensemble de données. Pour en savoir plus, consultez la section Qualificatif d'ensemble de données.
Exemple
-- Returns metadata for the table snapshots in the specified dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;
-- Returns metadata for the table snapshots in the specified region.
SELECT * FROM `region-us`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;
Exemple
La requête suivante récupère les métadonnées des instantanés de la table dans l'ensemble de données mydataset. Dans cet exemple, elle affiche l'instantané de table myproject.mydataset.mytablesnapshot, qui a été pris à partir de la table de base myproject.mydataset.mytable le 14 mai 2021 à 12h UTC.
SELECT * FROM `myproject`.mydataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;
Le résultat ressemble à ce qui suit :
+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+ | table_catalog | table_schema | table_name | base_table_catalog | base_table_schema | base_table_name | snapshot_time | +----------------+---------------+-----------------+----------------------------------------------------------------------------------------+ | myproject | mydataset | mytablesnapshot | myProject | mydataset | mytable | 2021-05-14 12:00:00.000 UTC | +----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+