Trabalhar com o histórico de alterações

O histórico de alterações permite rastrear o histórico de linhas anexadas a tabelas gerenciadas do Apache Iceberg (antigas tabelas do BigLake para Apache Iceberg no BigQuery). É possível usar a função com valor de tabela (TVF, na sigla em inglês) APPENDS do GoogleSQL para visualizar todas as linhas anexadas a uma tabela durante um período especificado, como linhas adicionadas por meio de instruções DDL CREATE TABLE, instruções DML INSERT e MERGE, jobs de carregamento em lote e ingestão de streaming.

As tabelas gerenciadas do Apache Iceberg usam conceitos e recursos do histórico de alterações do BigQuery para permitir o processamento de adições incrementais feitas às suas tabelas. Entender quais linhas foram adicionadas ao final de uma tabela pode ajudar você a manter uma réplica de tabela fora do BigQuery, auditar adições de dados históricos ou acionar pipelines downstream sem precisar de verificações completas de tabela ou cópias caras.

Permissões necessárias

Para ver o histórico de alterações em uma tabela gerenciada do Apache Iceberg, você precisa das seguintes permissões:

  • A permissão bigquery.tables.getData na tabela. Essa permissão está incluída nos seguintes papéis predefinidos do Identity and Access Management (IAM):
    • roles/bigquery.dataViewer
    • roles/bigquery.dataEditor
    • roles/bigquery.dataOwner
    • roles/bigquery.admin
  • A permissão bigquery.connections.delegate na conexão de recurso do Google Cloud associada à tabela. Essa permissão está incluída no papel de Usuário de conexão do BigQuery (roles/bigquery.connectionUser).
  • Além disso, a conta de serviço associada à conexão de recurso do Google Cloud precisa ter os papéis roles/storage.objectUser e roles/storage.legacyBucketReader no bucket do Cloud Storage.

Para mais requisitos de permissão quando uma tabela usa segurança no nível da linha ou da coluna, consulte Permissões necessárias na documentação do histórico de alterações do BigQuery.

Limitações

As tabelas gerenciadas do Apache Iceberg são compatíveis com o histórico de alterações e usam os mesmos conceitos e recursos do histórico de alterações padrão do BigQuery. Ao trabalhar com o histórico de alterações em tabelas gerenciadas do Apache Iceberg, as seguintes limitações se aplicam:

A seguir

Para mais informações, consulte a seguinte documentação do BigQuery: