Utiliser l'historique des modifications

L'historique des modifications vous permet de suivre l'historique des lignes ajoutées aux tables gérées Apache Iceberg (anciennement tables BigLake pour Apache Iceberg dans BigQuery). Vous pouvez utiliser la fonction de valeur de table (TVF) GoogleSQL APPENDS pour afficher toutes les lignes ajoutées à une table au cours d'une période spécifiée, telles que les lignes ajoutées via des instructions LDD CREATE TABLE, des instructions LMD INSERT et MERGE, des jobs de chargement par lot et l'ingestion en flux continu.

Les tables gérées Apache Iceberg utilisent les concepts et fonctionnalités de l'historique des modifications BigQuery pour vous permettre de traiter les ajouts incrémentiels apportés à vos tables. Comprendre quelles lignes ont été ajoutées à une table peut vous aider à gérer de manière incrémentielle une instance dupliquée de table en dehors de BigQuery, à auditer les ajouts de données historiques ou à déclencher des pipelines en aval sans nécessiter d'analyses complètes de la table ni de copies coûteuses.

Autorisations requises

Pour afficher l'historique des modifications d'une table gérée Apache Iceberg, vous devez disposer des autorisations suivantes :

  • L'autorisation bigquery.tables.getData sur la table. Cette autorisation est incluse dans les rôles IAM (Identity and Access Management) prédéfinis suivants :
    • roles/bigquery.dataViewer
    • roles/bigquery.dataEditor
    • roles/bigquery.dataOwner
    • roles/bigquery.admin
  • L'autorisation bigquery.connections.delegate sur la connexion de ressource Google Cloud associée à la table. Cette autorisation est incluse dans le rôle Utilisateur de connexion BigQuery (roles/bigquery.connectionUser).
  • De plus, le compte de service associé à la connexion de ressource Google Cloud doit disposer des rôles roles/storage.objectUser et roles/storage.legacyBucketReader sur le bucket Cloud Storage sous-jacent.

Pour connaître les autorisations supplémentaires requises lorsqu'une table utilise la sécurité au niveau des lignes ou des colonnes, consultez Autorisations requises dans la documentation sur l'historique des modifications BigQuery.

Limites

Les tables gérées Apache Iceberg sont compatibles avec l'historique des modifications et exploitent les mêmes concepts et fonctionnalités que l'historique des modifications BigQuery standard. Lorsque vous utilisez l'historique des modifications sur des tables gérées Apache Iceberg, les limites suivantes s'appliquent :

Étapes suivantes

Pour en savoir plus, consultez la documentation BigQuery suivante :