Configura le 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 essere a conoscenza dei costi sostenuti durante lo streaming delle modifiche.

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

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

Ruolo richiesto

Per ottenere le autorizzazioni necessarie per abilitare, disabilitare o modificare uno 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 da cui prevedi di trasmettere in streaming le modifiche

Abilitare un flusso di modifiche

Per attivare uno stream di modifiche su una tabella esistente, completa i seguenti passaggi:

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 uno stream di modifiche.

  3. Fai clic su Tabelle nel riquadro a sinistra.

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

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

  5. Fai clic su Abilita flusso di modifiche.

  6. Nel campo Expiration time (Tempo di scadenza), inserisci un numero compreso tra 1 e 7 per configurare il numero di giorni per cui devono essere conservati i record del 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 trasmettere in streaming le 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 delle modifiche per la tabella. Deve essere compreso tra uno e sette giorni, espresso come numero e una 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 lo stream delle modifiche di una tabella in qualsiasi momento. I record dello stream di dati creati prima della disattivazione delle modifiche in tempo reale continuano a consumare spazio di archiviazione fino alla successiva compattazione, ma non ti viene più addebitato alcun costo per lo spazio di archiviazione. Non puoi leggere uno stream delle modifiche dopo averlo disattivato, incluse le modifiche registrate prima della disattivazione.

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 Tabelle nel riquadro a sinistra.

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

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

  5. Deseleziona il segno di spunta da Abilita 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 trasmettere in streaming le modifiche
  • INSTANCE_ID: l'istanza che contiene la tabella
  • PROJECT_ID: il progetto che contiene l'istanza

Modificare il periodo di conservazione di un flusso di modifiche

Puoi modificare il numero di giorni in cui Bigtable conserva i record del flusso di modifiche. Se riduci il numero di giorni, i record di cui è stato eseguito lo streaming prima della modifica alla configurazione continuano a consumare spazio di archiviazione fino alla successiva compattazione. Dopo la modifica della configurazione, puoi trasmettere in streaming le modifiche solo dal periodo di tempo appena specificato.

Se aumenti il tempo di conservazione, la modifica non è retroattiva: i flussi di modifiche in tempo reale vengono conservati per il numero maggiore di giorni 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 Tabelle nel riquadro a sinistra.

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

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

  5. Nel campo Ora di scadenza, inserisci un numero compreso tra 1 e 7 per il numero di giorni in cui 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 trasmettere in streaming le 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 delle modifiche per la tabella. Deve essere compreso tra uno e sette giorni, espresso come numero e una lettera per l'unità. Le unità accettabili sono giorni (d), ore (h), minuti (m) e secondi (s). Esempio: 5d

Passaggi successivi