Configurare le modifiche in tempo reale

Se vuoi tenere traccia delle modifiche ai dati apportate a una tabella Bigtable, puoi abilitare un flusso di modifiche per la tabella e quindi leggerlo utilizzando un'applicazione come Dataflow. Prima di leggere questo documento, leggi la Panoramica delle modifiche in tempo reale. In particolare, assicurati di conoscere i costi sostenuti per le modifiche allo streaming.

Questa pagina descrive come abilitare, disabilitare e modificare il periodo di conservazione per una modifica in tempo reale.

Per istruzioni sulla creazione di una nuova tabella con un flusso di modifiche abilitato, consulta Creare una tabella.

Ruolo richiesto

Per ottenere le autorizzazioni necessarie per abilitare, disabilitare o modificare un flusso di modifiche di Bigtable, chiedi all'amministratore di concederti il seguente ruolo IAM.

  • Amministratore Bigtable (roles/bigtable.admin) sull'istanza Bigtable che contiene la tabella da cui prevedi di trasmettere le modifiche

Attivare un flusso di modifiche

Per abilitare un flusso di modifiche su una tabella esistente, segui questi 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 abilitare un flusso di modifiche.

  3. Fai clic su Tables nel riquadro a sinistra.

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

  4. Fai clic su Modifica per la tabella per cui vuoi abilitare un flusso 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 in cui devono essere conservati i record di stream di dati.

  7. Fai clic su Salva.

gcloud

Per abilitare un flusso 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 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 durante il quale Bigtable deve conservare i dati delle modifiche in tempo reale per la tabella. Non deve essere inferiore a un giorno e non più di sette giorni, espressi con un numero e una lettera per l'unità. Le unità accettabili sono giorni (d), ore (h), minuti (m) e secondi (s). Esempio: 5d

Disattivare una modifica in tempo reale

Puoi disabilitare il flusso di modifiche di una tabella in qualsiasi momento. I record di stream di dati creati prima della disattivazione del flusso di modifiche continueranno a consumare spazio di archiviazione fino alla successiva compazione, ma non ti verrà più addebitato alcun costo per questo spazio di archiviazione. Non puoi leggere una modifica in tempo reale dopo averla disabilitata, 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 Tabelle visualizza un elenco delle tabelle nell'istanza.

  4. Fai clic su Modifica per la tabella di cui vuoi disabilitare la configurazione del flusso di modifiche.

  5. Deseleziona il segno di spunta in Attiva flusso di modifiche.

  6. Fai clic su Salva.

gcloud

Per disabilitare un flusso 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 le modifiche
  • INSTANCE_ID: l'istanza che contiene la tabella
  • PROJECT_ID: il progetto che contiene l'istanza

Modificare la durata di conservazione di un flusso di modifiche

Puoi modificare il numero di giorni durante i quali Bigtable conserva i record dei flussi di modifiche. Se riduci il numero di giorni, i record trasmessi prima della modifica della configurazione continueranno a consumare spazio di archiviazione fino alla successiva compazione. Dopo la modifica della configurazione, potrai trasmettere in streaming solo le modifiche del periodo di tempo appena specificato.

Se aumenti il tempo di conservazione, non è retroattivo: le modifiche in tempo reale vengono conservate per l'aumento del numero di giorni a partire dal momento in cui modifichi la 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 Tabelle visualizza un elenco delle tabelle nell'istanza.

  4. Fai clic su Modifica per la tabella di cui vuoi modificare la configurazione del flusso di modifiche.

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

  6. Fai clic su Salva.

gcloud

Per modificare il periodo di conservazione per il flusso di 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 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 durante il quale Bigtable deve conservare i dati delle modifiche in tempo reale per la tabella. Il valore deve essere compreso tra uno e sette giorni, espresso sotto forma di numero e lettera per l'unità. Le unità accettabili sono giorni (d), ore (h), minuti (m) e secondi (s). Esempio: 5d

Passaggi successivi