Configurare modifiche in tempo reale

Se vuoi monitorare le modifiche ai dati apportate a una tabella Bigtable, puoi attivare una modifica in tempo reale per la tabella e poi leggerla utilizzando un'applicazione come Dataflow. Prima di leggere questo documento, consulta la Panoramica degli stream di modifiche. In particolare, assicurati di conoscere i costi sostenuti quando lo streaming cambia.

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 contenente la tabella da cui vuoi eseguire lo streaming delle modifiche

Attivare un flusso di modifiche

Per attivare uno stream 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 attivare un flusso di modifiche.

  3. Fai clic su Tables (Tabelle) nel riquadro a sinistra.

    La pagina 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 Attiva flusso di modifiche.

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

  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 cui Bigtable deve conservare i dati dello stream di modifiche per la tabella. Deve essere minimo un giorno e massimo sette giorni, espresso come numero e lettera per l'unità. Le unità accettabili 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 variazioni 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 (Tabelle) nel riquadro a sinistra.

    La pagina 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 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 \
        --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 occupare 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 modifiche in tempo reale 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 (Tabelle) nel riquadro a sinistra.

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

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

  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