Configurazione di garbage collection
Questa pagina mostra come visualizzare, impostare e aggiornare i criteri di garbage collection in Bigtable. Prima di leggere questa pagina, dovresti avere familiarità con la garbage collection.
Prima di utilizzare l'interfaccia a riga di comando cbt
, segui le istruzioni di configurazione, inclusi i passaggi per creare un file .cbtrc
.
Visualizzare i criteri di garbage collection attuali
Puoi utilizzare la console Google Cloud o cbt
CLI
per visualizzare i criteri di garbage collection di una famiglia di colonne.
Console
Per visualizzare il criterio di garbage collection corrente per una famiglia di colonne:
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza di cui vuoi visualizzare le tabelle.
Fai clic su Tables (Tabelle) nel riquadro a sinistra.
La pagina Tabelle mostra un elenco delle tabelle dell'istanza.
Fai clic su
Modifica nella riga della tabella.Fai clic su
Apri accanto alla famiglia di colonne che vuoi visualizzare.Quando hai finito di visualizzare il criterio di garbage collection, fai clic su Annulla per uscire.
cbt
Puoi cercare i criteri di garbage collection correnti per una determinata tabella eseguendo il seguente comando, sostituendo un ID tabella valido per TABLE_ID
:
cbt ls TABLE_ID
Imposta i criteri di garbage collection
Puoi impostare i criteri di garbage collection utilizzando la console Google Cloud, l'
cbt
CLI
o le librerie client di Cloud Bigtable.
Garbage collection in base all'età
La sezione seguente mostra come impostare l'età massima per i dati di una famiglia di colonne.
Console
Per impostare una data e un'ora di scadenza per le celle di una famiglia di colonne:
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza di cui vuoi visualizzare le tabelle.
Fai clic su Tables (Tabelle) nel riquadro a sinistra.
La pagina Tabelle mostra un elenco delle tabelle dell'istanza.
Fai clic su
Modifica.Fai clic su
Apri accanto alla famiglia di colonne che vuoi modificare.Seleziona Norma basata sull'età.
Inserisci l'età inserendo un numero nel campo Età massima e utilizzando il menu a discesa Unità per selezionare l'unità di tempo.
Ad esempio, per conservare i dati di una famiglia di colonne per 30 minuti, inserisci 30 e scegli minuti.
Fai clic su Salva.
cbt
Questo esempio crea una famiglia di colonne denominata cf1
, quindi imposta l'età massima
per i dati nella famiglia di colonne su cinque giorni. Questo indica a Bigtable di rimuovere tutti i dati con timestamp precedenti a cinque giorni in tutte le colonne di questa famiglia di colonne.
cbt createfamily your-table cf1
cbt setgcpolicy your-table cf1 maxage=5d
Vai
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Java
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Python
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C#
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
PHP
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Garbage collection in base al numero di versioni
La sezione seguente mostra come creare una famiglia di colonne con un criterio di garbage collection che indica il numero di versioni dei dati o il numero di celle da conservare.
Console
Per impostare il numero di celle o versioni da conservare in una famiglia di colonne:
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza di cui vuoi visualizzare le tabelle.
Fai clic su Tables (Tabelle) nel riquadro a sinistra.
La pagina Tabelle mostra un elenco delle tabelle dell'istanza.
Fai clic su
Modifica nella riga della tabella.Fai clic su
Apri accanto alla famiglia di colonne che vuoi modificare.Seleziona Criteri basati sulla versione.
Inserisci il numero di celle da conservare in ogni colonna della famiglia di colonne.
Fai clic su Salva.
cbt
Questo esempio crea una famiglia di colonne denominata cf2
, quindi imposta su due il numero di versioni da conservare nella famiglia di colonne. Questo indica a Bigtable di rimuovere tutte le celle tranne le due più recenti in tutte le colonne di questa famiglia di colonne.
cbt createfamily your-table cf2
cbt setgcpolicy your-table cf2 maxversions=2
Questo esempio imposta un criterio per rimuovere tutte le celle tranne l'ultima.
cbt setgcpolicy your-table cf2 maxversions=1
Vai
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Java
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Python
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C#
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
PHP
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Garbage collection basata su più criteri
La sezione seguente mostra come creare una famiglia di colonne con un criterio di garbage collection di intersezione.
Console
Per impostare un criterio di garbage collection di intersezione per le celle di una famiglia di colonne:
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza di cui vuoi visualizzare le tabelle.
Fai clic su Tables (Tabelle) nel riquadro a sinistra.
La pagina Tabelle mostra un elenco delle tabelle dell'istanza.
Fai clic su
Modifica nella riga della tabella.Fai clic su
Apri accanto alla famiglia di colonne che vuoi modificare.Seleziona Norma personalizzata.
Inserisci una regola di garbage collection nell'area di testo, impostando i valori per
maxage
,maxversions
o per entrambi. Le unità di età accettate sono ms, s, m, h e d, che indicano rispettivamente millisecondi, secondi, minuti, ore e giorni.Ad esempio, per rimuovere le celle più vecchie di cinque giorni e più vecchie delle due celle più recenti, inserisci quanto segue. Le celle devono soddisfare entrambi i criteri per essere rimosse.
maxage=5d and maxversions=2
Fai clic su Salva.
cbt
Questo esempio crea una famiglia di colonne denominata cf4
, quindi imposta un criterio di raccolta del garbage che rimuove le celle precedenti a cinque giorni e
precedenti alle due celle più recenti per tutte le colonne della famiglia di colonne.
Le celle devono soddisfare entrambi i criteri per essere rimosse.
cbt createfamily your-table cf4
cbt setgcpolicy your-table cf4 maxage=5d and maxversions=2
Questo esempio imposta un criterio che rimuove tutte le celle risalenti a più di 14 giorni fa tranne la più recente.
cbt setgcpolicy your-table cf4 maxage=14d and maxversions=1
Vai
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Java
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Python
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C#
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
PHP
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
La sezione seguente mostra come creare una famiglia di colonne con un criterio di garbage collection unione.
Console
Per impostare un criterio di garbage collection di unione per le celle di una famiglia di colonne:
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza di cui vuoi visualizzare le tabelle.
Fai clic su Tables (Tabelle) nel riquadro a sinistra.
La pagina Tabelle mostra un elenco delle tabelle dell'istanza.
Fai clic su
Modifica nella riga della tabella.Fai clic su
Apri accanto alla famiglia di colonne che vuoi modificare.Seleziona Norma personalizzata.
Inserisci una regola di garbage collection nell'area di testo, impostando i valori per
maxage
,maxversions
o per entrambi. Le unità di età accettate sono ms, s, m, h e d, che indicano rispettivamente millisecondi, secondi, minuti, ore e giorni.Ad esempio, per rimuovere le celle risalenti a più di cinque giorni fa o più vecchie delle due celle più recenti, inserisci quanto segue. Le celle devono soddisfare uno dei due criteri per essere rimosse.
maxage=5d or maxversions=2
Fai clic su Salva.
cbt
Questo esempio crea una famiglia di colonne denominata cf3
, quindi imposta un criterio di raccolta dei rifiuti che rimuove le celle risalenti a più di cinque giorni fa o
sono precedenti alle due celle più recenti. Per essere rimosse, le celle devono soddisfare una delle condizioni.
cbt createfamily your-table cf3
cbt setgcpolicy your-table cf3 maxage=5d or maxversions=2
Questo esempio imposta un criterio che rimuove tutti i valori delle celle tranne l'ultimo, ma rimuove anche la cella più recente se è trascorso più di un secondo.
cbt setgcpolicy your-table cf3 maxversions=1 or maxage=1s
Vai
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Java
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Python
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C#
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
PHP
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
La sezione seguente mostra come creare una famiglia di colonne con un criterio di garbage collection nidificato. Un criterio di garbage collection nidificato ha una combinazione di regole di unione e intersezione.
Console
Per impostare un criterio di garbage collection nidificato per le celle di una famiglia di colonne:
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza di cui vuoi visualizzare le tabelle.
Fai clic su Tables (Tabelle) nel riquadro a sinistra.
La pagina Tabelle mostra un elenco delle tabelle dell'istanza.
Fai clic su
Modifica nella riga della tabella.Fai clic su
Apri accanto alla famiglia di colonne che vuoi modificare.Seleziona Norma personalizzata.
Inserisci una regola di garbage collection nell'area di testo, impostando i valori per
maxage
,maxversions
o per entrambi. Le unità di età accettate sono ms, s, m, h e d, che indicano rispettivamente millisecondi, secondi, minuti, ore e giorni.Ad esempio, per mantenere le due celle più recenti anche se sono trascorsi più di un minuto o per mantenere le dieci celle più recenti purché siano trascorsi meno di un minuto, inserisci quanto segue:
(maxage=1m and maxversions=2) or maxversions=10
Fai clic su Salva.
cbt
Questo esempio crea una famiglia di colonne denominata cf5
, quindi imposta un criterio di raccolta dei rifiuti che rimuove le celle della famiglia di colonne che soddisfano una delle seguenti condizioni:
- Più vecchie delle dieci celle più recenti
- Sono trascorsi più di un minuto e sono precedenti alle due celle più recenti
In altre parole, questo criterio conserva le due celle più recenti anche se sono trascorsi più di un minuto o conserva le dieci celle più recenti purché siano trascorsi meno di un minuto.
cbt createfamily your-table cf5
cbt setgcpolicy your-table cf5 "(maxage=1m and maxversions=2) or
maxversions=10"
Vai
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Java
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Python
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C#
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
PHP
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Aggiornare un criterio di garbage collection
La sezione seguente mostra come modificare un criterio di garbage collection esistente.
Per aumentare il periodo di conservazione di una famiglia di colonne in una tabella che utilizza la replica, devi confermare un avviso relativo alla potenziale mancata sincronizzazione dei tuoi cluster. Il nuovo valore non deve essere più di 90 giorni successivo rispetto al valore corrente. Per maggiori dettagli, consulta Modificare i criteri basati sull'età.
Console
Per aggiornare il criterio di garbage collection per una famiglia di colonne, segui questi passaggi.
Apri l'elenco delle istanze Bigtable nella console Google Cloud.
Fai clic sull'istanza di cui vuoi visualizzare le tabelle.
Fai clic su Tables (Tabelle) nel riquadro a sinistra.
La pagina Tabelle mostra un elenco delle tabelle dell'istanza.
Fai clic su
Modifica nella riga della tabella.Fai clic su
Apri accanto alla famiglia di colonne che vuoi modificare.Fai clic su Salva.
cbt
cbt setgcpolicy your-table cf1 maxage=1d
Se aumenti il valore di maxage
in una tabella replicata, devi utilizzare il flag facoltativo force
. Il nuovo valore non deve superare i 90 giorni in più rispetto al valore corrente.
Java
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Python
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C#
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
PHP
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client Bigtable.
Per autenticarti a Bigtable, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Passaggi successivi
- Esamina altri esempi di codice.
- Esplora le strategie per simulare il TTL a livello di cella.
- Scopri in che modo i timestamp che sono numeri sequenziali influiscono sulla raccolta del garbage.
- Scopri come conservare solo il valore più recente di una colonna.