Configurazione di garbage collection
Questa pagina mostra come visualizzare, impostare e aggiornare i criteri di garbage collection in Bigtable . Prima di leggere questa pagina, devi acquisire 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
.
Visualizza i criteri di garbage collection attuali
Puoi utilizzare la console Google Cloud o l'interfaccia a riga di comando cbt
per visualizzare i criteri di garbage collection di una famiglia di colonne.
Console
Per visualizzare il criterio di garbage collection attuale 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 nel riquadro a sinistra.
La pagina Tabelle visualizza un elenco delle tabelle nell'istanza.
Fai clic su
Modifica nella riga della tabella.Fai clic su
Apri accanto alla famiglia di colonne da visualizzare.Quando hai finito di visualizzare il criterio di garbage collection, fai clic su Annulla per uscire.
cbt
Puoi cercare gli attuali criteri di garbage collection per una determinata tabella eseguendo questo comando, sostituendo un ID tabella valido con 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'
interfaccia a riga di comando cbt
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 in una famiglia di colonne.
Console
Per impostare una 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 nel riquadro a sinistra.
La pagina Tabelle visualizza un elenco delle tabelle nell'istanza.
Fai clic su
Modifica.Fai clic su
Apri accanto alla famiglia di colonne da modificare.Seleziona Criterio basato 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
In questo esempio viene creata una famiglia di colonne denominata cf1
, quindi viene impostata l'età massima per i dati della 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
Go
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Java
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
C#
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
PHP
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Garbage collection in base al numero di versioni
La seguente sezione mostra come creare una famiglia di colonne con un criterio di garbage collection che indichi 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 nel riquadro a sinistra.
La pagina Tabelle visualizza un elenco delle tabelle nell'istanza.
Fai clic su
Modifica nella riga della tabella.Fai clic su
Apri accanto alla famiglia di colonne da modificare.Seleziona Criterio basato sulla versione.
Inserisci il numero di celle da conservare in ogni colonna della famiglia di colonne.
Fai clic su Salva.
cbt
In questo esempio viene creata una famiglia di colonne denominata cf2
, quindi viene impostato su due il numero di versioni da mantenere nella famiglia di colonne. Questo indica a Bigtable di rimuovere tutte le celle di questa famiglia di colonne tranne le due più recenti.
cbt createfamily your-table cf2
cbt setgcpolicy your-table cf2 maxversions=2
Questo esempio imposta un criterio per rimuovere tutte le celle tranne quella più recente.
cbt setgcpolicy your-table cf2 maxversions=1
Go
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Java
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
C#
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
PHP
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, 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 per le intersezioni 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 nel riquadro a sinistra.
La pagina Tabelle visualizza un elenco delle tabelle nell'istanza.
Fai clic su
Modifica nella riga della tabella.Fai clic su
Apri accanto alla famiglia di colonne da modificare.Seleziona Criterio personalizzato.
Inserisci una regola di garbage collection nell'area di testo, impostando i valori per
maxage
,maxversions
o entrambi. Le unità di età accettabili sono ms, s, m, h e d, che corrispondono a millisecondi, secondi, minuti, ore e giorni.Ad esempio, per rimuovere le celle che risalgono a più di cinque giorni fa e hanno più di cinque giorni rispetto alle due celle più recenti, inserisci quanto segue. Per poter essere rimosse, le celle devono soddisfare entrambi i criteri.
maxage=5d and maxversions=2
Fai clic su Salva.
cbt
In questo esempio viene creata una famiglia di colonne denominata cf4
, poi viene impostato un criterio di garbage collection che rimuove le celle più vecchie di cinque giorni e precedenti alle due celle più recenti per tutte le colonne della famiglia di colonne.
Per poter essere rimosse, le celle devono soddisfare entrambi i criteri.
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 più vecchie di 14 giorni, tranne quella più recente.
cbt setgcpolicy your-table cf4 maxage=14d and maxversions=1
Go
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Java
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
C#
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
PHP
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, 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 Union 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 nel riquadro a sinistra.
La pagina Tabelle visualizza un elenco delle tabelle nell'istanza.
Fai clic su
Modifica nella riga della tabella.Fai clic su
Apri accanto alla famiglia di colonne da modificare.Seleziona Criterio personalizzato.
Inserisci una regola di garbage collection nell'area di testo, impostando i valori per
maxage
,maxversions
o entrambi. Le unità di età accettabili sono ms, s, m, h e d, che corrispondono a millisecondi, secondi, minuti, ore e giorni.Ad esempio, per rimuovere le celle che risalgono a più di cinque giorni prima o che sono più vecchie delle due celle più recenti, inserisci quanto segue. Per poter essere rimosse, le celle devono soddisfare uno dei criteri.
maxage=5d or maxversions=2
Fai clic su Salva.
cbt
In questo esempio viene creata una famiglia di colonne denominata cf3
, quindi viene impostato un criterio di garbage collection che rimuove le celle che risalgono a più di cinque giorni prima o che risalgono alle ultime due celle. Per poter 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 quella più recente, ma rimuove anche la cella più recente se risale a più di un secondo.
cbt setgcpolicy your-table cf3 maxversions=1 or maxage=1s
Go
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Java
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
C#
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
PHP
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, 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 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 nel riquadro a sinistra.
La pagina Tabelle visualizza un elenco delle tabelle nell'istanza.
Fai clic su
Modifica nella riga della tabella.Fai clic su
Apri accanto alla famiglia di colonne da modificare.Seleziona Criterio personalizzato.
Inserisci una regola di garbage collection nell'area di testo, impostando i valori per
maxage
,maxversions
o entrambi. Le unità di età accettabili sono ms, s, m, h e d, che corrispondono a millisecondi, secondi, minuti, ore e giorni.Ad esempio, per mantenere le due celle più recenti anche se risalgono a più di un minuto fa, o per mantenere le dieci celle più recenti finché non risalgono a più di un minuto, inserisci quanto segue:
(maxage=1m and maxversions=2) or maxversions=10
Fai clic su Salva.
cbt
In questo esempio viene creata una famiglia di colonne denominata cf5
, quindi viene impostato un criterio di garbage collection che rimuove le celle della famiglia di colonne che soddisfano una delle seguenti condizioni:
- Meno delle dieci celle più recenti
- Più vecchie di un minuto e più vecchie delle due celle più recenti
In altre parole, questo criterio mantiene le due celle più recenti anche se sono vecchie di più di un minuto o le dieci celle più recenti fino a quando non hanno meno di un minuto.
cbt createfamily your-table cf5
cbt setgcpolicy your-table cf5 "(maxage=1m and maxversions=2) or
maxversions=10"
Go
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Java
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
C#
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
PHP
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Aggiorna un criterio di garbage collection
La seguente sezione mostra come modificare un criterio di garbage collection esistente.
Per aumentare il periodo di conservazione per una famiglia di colonne in una tabella che utilizza la replica, devi accettare un avviso sulla possibilità che i cluster non siano più sincronizzati. Il nuovo valore non deve superare di oltre 90 giorni il 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 nel riquadro a sinistra.
La pagina Tabelle visualizza un elenco delle tabelle nell'istanza.
Fai clic su
Modifica nella riga della tabella.Fai clic su
Apri accanto alla famiglia di colonne da 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
più del valore corrente.
Java
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
C#
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
C++
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Node.js
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
PHP
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Ruby
Per scoprire come installare e utilizzare la libreria client per Bigtable, consulta Librerie client di Bigtable.
Per eseguire l'autenticazione in Bigtable, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Passaggi successivi
- Guarda altri esempi di codice.
- Esplora le strategie per simulare il TTL a livello di cella.
- Leggi come i timestamp che sono numeri sequenziali influiscono sulla garbage collection.
- Scopri come conservare solo il valore più recente di una colonna.