La cronologia delle modifiche ti consente di monitorare la cronologia delle righe aggiunte alle tabelle gestite di Apache Iceberg (in precedenza tabelle BigLake per Apache Iceberg in BigQuery). Puoi utilizzare la funzione con valore di tabella (TVF) APPENDS di GoogleSQL per visualizzare tutte le righe aggiunte a una tabella durante un intervallo di tempo specificato, ad esempio le righe aggiunte tramite istruzioni DDL CREATE TABLE, istruzioni DML INSERT e MERGE, job di caricamento batch e importazione di flussi di dati.
Le tabelle gestite di Apache Iceberg utilizzano concetti e funzionalità della cronologia delle modifiche di BigQuery per consentirti di elaborare le aggiunte incrementali apportate alle tue tabelle. Capire quali righe sono state aggiunte a una tabella può aiutarti a mantenere in modo incrementale una replica della tabella al di fuori di BigQuery, controllare le aggiunte di dati storici o attivare pipeline downstream senza richiedere scansioni complete della tabella o copie costose.
Autorizzazioni obbligatorie
Per visualizzare la cronologia delle modifiche di una tabella gestita Apache Iceberg, devi disporre delle seguenti autorizzazioni:
- L'autorizzazione
bigquery.tables.getDatasulla tabella. Questa autorizzazione è inclusa nei seguenti ruoli IAM (Identity and Access Management) predefiniti:roles/bigquery.dataViewerroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/bigquery.admin
- L'autorizzazione
bigquery.connections.delegatesulla connessione alla risorsa Google Cloud associata alla tabella. Questa autorizzazione è inclusa nel ruolo BigQuery Connection User (roles/bigquery.connectionUser). - Inoltre, il account di servizio associato alla connessione alla risorsa Google Cloud deve disporre dei ruoli
roles/storage.objectUsereroles/storage.legacyBucketReadersul bucket Cloud Storage sottostante.
Per ulteriori requisiti di autorizzazione quando una tabella utilizza la sicurezza a livello di riga o di colonna, consulta Autorizzazioni richieste nella documentazione della cronologia delle modifiche di BigQuery.
Limitazioni
Le tabelle gestite di Apache Iceberg supportano la cronologia delle modifiche e sfruttano gli stessi concetti e le stesse funzionalità della cronologia delle modifiche standard di BigQuery. Quando utilizzi la cronologia delle modifiche nelle tabelle gestite di Apache Iceberg, si applicano le seguenti limitazioni:
- La cronologia delle modifiche è supportata solo per le tabelle gestite Apache Iceberg (precedentemente tabelle BigLake per Apache Iceberg in BigQuery).
- La funzione con valori di tabella (TVF)
CHANGESnon è supportata per le tabelle gestite di Apache Iceberg. È supportata solo la TVFAPPENDS. - Si applicano anche le limitazioni per le tabelle gestite di Apache Iceberg.
- Si applicano anche le limitazioni per la funzione di cronologia delle modifiche di
APPENDS.
Passaggi successivi
Per saperne di più, consulta la seguente documentazione di BigQuery:
- Utilizza la cronologia delle modifiche
- Riferimento TVF
APPENDS - Crea e utilizza tabelle gestite Apache Iceberg
- Scopri come utilizzare una query continua BigQuery per leggere dati in tempo reale dalle tabelle gestite da Apache Iceberg