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
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza contenente la tabella per cui vuoi abilitare un flusso di modifiche.
Fai clic su Tables nel riquadro a sinistra.
La pagina Tabelle visualizza un elenco delle tabelle nell'istanza.
Fai clic su Modifica per la tabella per cui vuoi abilitare un flusso di modifiche.
Fai clic su Attiva flusso di modifiche.
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.
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 modificheINSTANCE_ID
: l'istanza che contiene la tabellaPROJECT_ID
: il progetto che contiene l'istanzaCHANGE_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
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza di cui vuoi visualizzare le tabelle.
Fai clic su Tables nel riquadro a sinistra.
La pagina Tabelle visualizza un elenco delle tabelle nell'istanza.
Fai clic su Modifica per la tabella di cui vuoi disabilitare la configurazione del flusso di modifiche.
Deseleziona il segno di spunta in Attiva flusso di modifiche.
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 modificheINSTANCE_ID
: l'istanza che contiene la tabellaPROJECT_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
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza di cui vuoi visualizzare le tabelle.
Fai clic su Tables nel riquadro a sinistra.
La pagina Tabelle visualizza un elenco delle tabelle nell'istanza.
Fai clic su Modifica per la tabella di cui vuoi modificare la configurazione del flusso di modifiche.
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.
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 modificheINSTANCE_ID
: l'istanza che contiene la tabellaPROJECT_ID
: il progetto che contiene l'istanzaCHANGE_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
- Leggi un flusso di modifiche con Dataflow.
- Esamina i prezzi di Bigtable.
- Completa una guida rapida per scoprire come abilitare un flusso di modifiche e visualizzare le modifiche.
- Utilizza la libreria client di Cloud Bigtable per Java per leggere i flussi di modifiche.
- Segui un tutorial sull'elaborazione di un flusso di modifiche.