Trabaja con el historial de cambios

El historial de cambios te permite hacer un seguimiento del historial de las filas que se agregan a las tablas administradas de Apache Iceberg (antes, tablas de BigLake para Apache Iceberg en BigQuery). Puedes usar la función con valores de tabla (TVF) APPENDS de GoogleSQL para ver todas las filas agregadas a una tabla durante un período específico, como las filas agregadas a través de sentencias DDL CREATE TABLE, sentencias DML INSERT y MERGE, trabajos de carga por lotes y transferencia de transmisión.

Las tablas administradas de Apache Iceberg usan conceptos y capacidades del historial de cambios de BigQuery para permitirte procesar las adiciones incrementales que se realizan en tus tablas. Comprender qué filas se agregaron a una tabla puede ayudarte a mantener de forma incremental una réplica de la tabla fuera de BigQuery, auditar las adiciones de datos históricos o activar canalizaciones downstream sin necesidad de realizar análisis de tablas completos ni copias costosas.

Permisos necesarios

Para ver el historial de cambios en una tabla administrada de Apache Iceberg, necesitas los siguientes permisos:

  • El permiso bigquery.tables.getData en la tabla. Este permiso se incluye en los siguientes roles predefinidos de Identity and Access Management (IAM):
    • roles/bigquery.dataViewer
    • roles/bigquery.dataEditor
    • roles/bigquery.dataOwner
    • roles/bigquery.admin
  • El permiso bigquery.connections.delegate en el recurso de conexión de Google Cloud asociado con la tabla. Este permiso se incluye en el rol Usuario de conexión de BigQuery (roles/bigquery.connectionUser).
  • Además, la cuenta de servicio asociada con la conexión del recurso Google Cloud debe tener los roles roles/storage.objectUser y roles/storage.legacyBucketReader en el bucket de Cloud Storage subyacente.

Para conocer los requisitos de permisos adicionales cuando una tabla usa la seguridad a nivel de fila o de columna, consulta Permisos obligatorios en la documentación del historial de cambios de BigQuery.

Limitaciones

Las tablas administradas de Apache Iceberg admiten el historial de cambios y aprovechan los mismos conceptos y capacidades que el historial de cambios estándar de BigQuery. Cuando trabajas con el historial de cambios en las tablas administradas de Apache Iceberg, se aplican las siguientes limitaciones:

¿Qué sigue?

Para obtener más información, consulta la siguiente documentación de BigQuery: