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
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 : nom de la région de l'ensemble de données. Par 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 |
+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+