Configurare i flussi di modifiche

Se vuoi tenere traccia delle modifiche ai dati apportate a una tabella Bigtable, puoi abilitare un flusso di modifiche per la tabella e leggerlo utilizzando un'applicazione come Dataflow. Prima di leggere questo documento, consulta la Panoramica degli stream di modifiche. In particolare, di essere a conoscenza dei costi sostenuti per il flusso di modifiche.

Questa pagina descrive come attivare, disattivare e modificare il periodo di conservazione per un stream di modifiche.

Per istruzioni su come creare una nuova tabella con un flusso di modifiche abilitato, consulta Creare una tabella.

Ruolo richiesto

Per ottenere le autorizzazioni necessarie per attivare, disattivare o modificare un stream di modifiche Bigtable, chiedi all'amministratore di concederti il seguente ruolo IAM.

  • Amministratore Bigtable (roles/bigtable.admin) nell'istanza Bigtable che contiene la tabella che prevedi modifiche al flusso da

Attivare un flusso di modifiche

Per abilitare un flusso di modifiche in una tabella esistente:

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud.

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza contenente la tabella per cui vuoi abilitare una modifica contenuti in streaming.

  3. Fai clic su Tables nel riquadro a sinistra.

    La pagina Tables (Tabelle) mostra un elenco delle tabelle dell'istanza.

  4. Fai clic su Modifica per la tabella per cui vuoi attivare un stream di modifiche.

  5. Fai clic su Abilita modifiche in tempo reale.

  6. Nel campo Data di scadenza, inserisci un numero compreso tra 1 e 7 per configurare il numero di giorni in cui devono essere i record degli stream di dati vengono mantenuti.

  7. Fai clic su Salva.

gcloud

Per attivare uno stream di modifiche in una tabella, utilizza il comando gcloud bigtable instances tables update.

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD

Sostituisci quanto segue:

  • TABLE_ID: l'ID della tabella di cui vuoi eseguire lo streaming delle modifiche
  • INSTANCE_ID: l'istanza che contiene la tabella
  • PROJECT_ID: il progetto che contiene l'istanza
  • CHANGE_STREAM_RETENTION_PERIOD: il periodo di tempo per il quale Bigtable deve conservare i dati dello stream di modifiche per la tabella. Deve essere non inferiore a 1 giorno e non superiore a 7 giorni, espressi in numero e una lettera per l'unità. Le unità accettate sono giorni (d), ore (h), minuti (m) e secondi (s). Esempio: 5d

Disattivare un flusso di modifiche

Puoi disattivare il flusso di modifiche di una tabella in qualsiasi momento. I record dello stream di dati che sono stati creati prima di disattivare lo stream di modifiche continuano a consumare spazio di archiviazione fino al successivo compaction, ma non ti viene più addebitato alcun costo per lo spazio di archiviazione. Non puoi leggere uno stream di modifiche dopo averlo disattivato, incluse le modifiche registrate prima della disattivazione dello stream.

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud.

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza di cui vuoi visualizzare le tabelle.

  3. Fai clic su Tables nel riquadro a sinistra.

    La pagina Tables (Tabelle) mostra un elenco delle tabelle dell'istanza.

  4. Fai clic su Modifica per la tabella di cui vuoi disattivare la configurazione dello stream di modifiche.

  5. Rimuovi il segno di spunta da Attiva flusso di modifiche.

  6. Fai clic su Salva.

gcloud

Per disattivare un flusso di modifiche in una tabella, utilizza gcloud bigtable instances tables update .

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --clear-change-stream-retention-period

Sostituisci quanto segue:

  • TABLE_ID: l'ID della tabella di cui vuoi eseguire lo streaming delle modifiche
  • INSTANCE_ID: l'istanza che contiene la tabella
  • PROJECT_ID: il progetto che contiene l'istanza

Modificare il tempo di conservazione di un flusso di modifiche

Puoi modificare il numero di giorni per cui Bigtable conserva i record del flusso di modifiche. Se riduci il numero di giorni, i record sottoposti a streaming prima della modifica della configurazione continuano a consumare spazio di archiviazione fino alla successiva compazione. Dopo la modifica della configurazione, puoi eseguire lo streaming delle modifiche solo dal periodo di tempo appena specificato.

Se aumenti il tempo di conservazione, la modifica non è retroattiva: gli stream di modifiche vengono conservati per il numero di giorni aumentato a partire dalla modifica della configurazione.

Console

  1. Apri l'elenco delle istanze Bigtable nella console Google Cloud.

    Apri l'elenco delle istanze

  2. Fai clic sull'istanza di cui vuoi visualizzare le tabelle.

  3. Fai clic su Tables nel riquadro a sinistra.

    La pagina Tables (Tabelle) mostra un elenco delle tabelle dell'istanza.

  4. Fai clic su Modifica per la tabella di cui vuoi configurare la modifica delle modifiche. da modificare.

  5. Nel campo Data e ora di scadenza, inserisci un numero compreso tra 1 e 7 per il numero di giorni per i quali devono essere conservati i record dello stream di dati.

  6. Fai clic su Salva.

gcloud

Per modificare il periodo di conservazione dello stream delle modifiche di una tabella, utilizza il comando gcloud bigtable instances tables update.

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD

Sostituisci quanto segue:

  • TABLE_ID: l'ID della tabella di cui vuoi eseguire lo streaming delle modifiche
  • INSTANCE_ID: l'istanza che contiene la tabella
  • PROJECT_ID: il progetto che contiene l'istanza
  • CHANGE_STREAM_RETENTION_PERIOD: il periodo di tempo per il quale Bigtable deve conservare i dati dello stream di modifiche per la tabella. Deve essere compreso tra 1 e 7 giorni, espresso come numero e lettera per l'unità. Le unità accettate sono giorni (d), ore (h), minuti (m) e secondi (s). Esempio: 5d

Passaggi successivi