Utilizzare la cronologia delle modifiche

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Nota: per ricevere assistenza durante l'anteprima, contatta [e-mail].

La cronologia delle modifiche di BigQuery ti consente di monitorare la cronologia delle modifiche apportate a una tabella BigQuery. Puoi utilizzare le funzioni GoogleSQL per visualizzare tipi specifici di modifiche apportate durante un intervallo di tempo specificato, in modo da poter elaborare le modifiche incrementali apportate a una tabella. Comprendere le modifiche apportate a una tabella può aiutarti a eseguire operazioni come mantenere in modo incrementale una replica della tabella al di fuori di BigQuery evitando copie costose.

Autorizzazioni obbligatorie

Per visualizzare la cronologia delle modifiche in una tabella, devi disporre dell'autorizzazione bigquery.tables.getData per quella tabella. I seguenti ruoli IAM (Identity and Access Management) predefiniti includono questa autorizzazione:

• roles/bigquery.dataViewer
• roles/bigquery.dataEditor
• roles/bigquery.dataOwner
• roles/bigquery.admin

Se una tabella ha o ha avuto criteri di accesso a livello di riga, solo un amministratore della tabella può accedere ai dati storici della tabella. L'autorizzazione bigquery.rowAccessPolicies.overrideTimeTravelRestrictions è obbligatoria nella tabella ed è inclusa nel ruolo IAM predefinito roles/bigquery.admin.

Se una tabella ha la sicurezza a livello di colonna, puoi visualizzare la cronologia delle modifiche solo per le colonne a cui hai accesso.

Funzioni della cronologia delle modifiche

Per comprendere la cronologia delle modifiche di una tabella, puoi utilizzare le seguenti funzioni:

• APPENDS: restituisce tutte le righe aggiunte a una tabella per un determinato intervallo di tempo.

  Le seguenti operazioni aggiungono righe alla cronologia delle modifiche APPENDS:

  • CREATE TABLE Istruzione DDL
  • INSERT Istruzione DML
  • Dati aggiunti nell'ambito di un'istruzione DML MERGE
  • Caricare i dati in BigQuery
  • Importazione di streaming

• CHANGES: restituisce tutte le righe che sono state modificate in una tabella per un determinato intervallo di tempo. Per utilizzare la funzione CHANGES in una tabella, devi impostare l'opzione enable_change_history della tabella su TRUE.

  Le seguenti operazioni aggiungono righe alla cronologia delle modifiche CHANGES:

  • CREATE TABLE Istruzione DDL
  • INSERT Istruzione DML
  • Dati aggiunti o modificati nell'ambito di un'istruzione DML MERGE
  • UPDATE Istruzione DML
  • DELETE Istruzione DML
  • Caricare i dati in BigQuery
  • Importazione di streaming
  • TRUNCATE TABLE Istruzione DML
  • Job configurati con un writeDisposition di WRITE_TRUNCATE
  • Eliminazioni di singole partizioni di tabelle

Prezzi e costi

L'uso delle funzioni di cronologia delle modifiche comporta costi di calcolo di BigQuery. Sia le funzioni APPENDS che CHANGES richiedono l'elaborazione di tutti i dati scritti nella tabella nell'intervallo di tempo specificato. Questa elaborazione si applica a tutte le scritture, incluse le operazioni di accodamento e mutazione. L'impostazione dell'opzione enable_change_history di una tabella su FALSE non riduce i dati elaborati da APPENDS.

Quando imposti l'opzione enable_change_history su una tabella su TRUE per utilizzare la funzione CHANGES, BigQuery archivia i metadati delle modifiche alla tabella. Questi metadati archiviati comportano costi di archiviazione e di calcolo di BigQuery aggiuntivi. L'importo fatturato dipende dal numero e dal tipo di modifiche apportate alla tabella ed è in genere ridotto. Le tabelle con molte operazioni di modifica, in particolare le eliminazioni di grandi dimensioni, sono quelle che hanno maggiori probabilità di comportare costi significativi.