Configurar a coleta de lixo
Nesta página, mostramos como visualizar, definir e atualizar políticas de coleta de lixo no Bigtable. Antes de ler esta página, conheça a coleta de lixo.
Antes de usar o
CLI cbt
, siga as instruções de configuração, incluindo as etapas para criar um arquivo .cbtrc
.
Ver as políticas atuais de coleta de lixo
É possível usar o console do Google Cloud ou a
CLI cbt
para conferir as
políticas de coleta de lixo de um grupo de colunas.
Console
Para visualizar a política atual de coleta de lixo de um grupo de colunas:
Abra a lista de instâncias do Bigtable no Console do Google Cloud.
Clique na instância em que estão as tabelas a serem visualizadas.
Clique em Tabelas no painel esquerdo.
A página "Tabelas" exibe uma lista de tabelas na instância.
Clique em Editar
na linha da tabela.Clique em
Abrir ao lado do grupo de colunas que você quer visualizar.Quando terminar de visualizar a política de coleta de lixo, clique em Cancelar para sair.
cbt
É possível procurar as políticas atuais de coleta de lixo de uma determinada tabela executando o seguinte comando, substituindo um código de tabela válido por TABLE_ID
:
cbt ls TABLE_ID
Definir políticas de coleta de lixo
É possível definir políticas de coleta de lixo usando o Console do Google Cloud, a
CLI cbt
ou as bibliotecas de cliente
do Cloud Bigtable.
Coleta de lixo com base na idade
A seção a seguir mostra como definir a idade máxima dos dados em um grupo de colunas.
Console
Para definir um prazo de validade para as células de um grupo de colunas:
Abra a lista de instâncias do Bigtable no Console do Google Cloud.
Clique na instância em que estão as tabelas a serem visualizadas.
Clique em Tabelas no painel esquerdo.
A página "Tabelas" exibe uma lista de tabelas na instância.
Clique em "Editar"
.Clique em Abrir
ao lado do grupo de colunas que você quer editar.Selecione Política baseada em idade.
Insira a idade inserindo um número no campo Idade máxima e usando no menu suspenso Unidade para selecionar a unidade de tempo.
Por exemplo, para reter os dados de um grupo de colunas por 30 minutos, digite 30 e escolha minutos.
Clique em Save.
cbt
Neste exemplo, criamos um grupo de colunas chamado cf1
e definimos para os dados dele a idade máxima de cinco dias. Isso diz ao Bigtable
para remover todos os dados com carimbos de data/hora anteriores a cinco dias em todas as colunas desse
grupo.
cbt createfamily your-table cf1
cbt setgcpolicy your-table cf1 maxage=5d
Go
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Java
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Python
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
C#
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
C++
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Node.js
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
PHP
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Ruby
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Coleta de lixo com base no número de versões
A seção a seguir mostramcomo criar um grupo de colunas com uma política de coleta de lixo que declara o número de versões dos dados, ou número de células, a serem mantidos.
Console
Para definir o número de células ou versões que serão mantidas em um grupo de colunas:
Abra a lista de instâncias do Bigtable no Console do Google Cloud.
Clique na instância em que estão as tabelas a serem visualizadas.
Clique em Tabelas no painel esquerdo.
A página "Tabelas" exibe uma lista de tabelas na instância.
Clique em Editar
na linha da tabela.Clique em Abrir
ao lado do grupo de colunas que você quer editar.Selecione Política baseada em versão.
Insira o número de células que serão mantidas em cada coluna no grupo.
Clique em Save.
cbt
Neste exemplo, criamos um grupo de colunas chamado cf2
e definimos que dois é o número de
versões a serem mantidas nele. Isso diz
ao Bigtable para remover todas as células mais recentes em todas
as colunas deste grupo de colunas, exceto as duas mais recentes.
cbt createfamily your-table cf2
cbt setgcpolicy your-table cf2 maxversions=2
Neste exemplo, definimos uma política para remover todas as células, exceto a mais recente.
cbt setgcpolicy your-table cf2 maxversions=1
Go
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Java
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Python
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
C#
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
C++
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Node.js
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
PHP
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Ruby
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Coleta de lixo com base em vários critérios
A seção a seguir demonstra como criar um grupo de colunas com uma política de coleta de lixo de intersecção.
Console
Para definir uma política de coleta de lixo de intersecção para células em um grupo de colunas:
Abra a lista de instâncias do Bigtable no Console do Google Cloud.
Clique na instância em que estão as tabelas a serem visualizadas.
Clique em Tabelas no painel esquerdo.
A página "Tabelas" exibe uma lista de tabelas na instância.
Clique em Editar
na linha da tabela.Clique em Abrir
ao lado do grupo de colunas que você quer editar.Selecione Política personalizada.
Insira uma regra de coleta de lixo na área de texto, definindo valores para
maxage
e/oumaxversions
. As unidades aceitáveis são: ms, s, m, h e d, que significam milissegundos, segundos, minutos, horas e dias.Por exemplo, para remover as células com mais de cinco dias e que são mais antigas que as duas células mais recentes, digite o comando a seguir. As células precisam atender a ambos os critérios para serem removidas.
maxage=5d and maxversions=2
Clique em Save.
cbt
Neste exemplo, criamos um grupo de colunas chamado cf4
e definimos uma política de coleta
de lixo que remove as células com mais de cinco dias e
que são mais antigas que as duas células mais recentes em todas as colunas no grupo.
As células precisam atender a ambos os critérios para serem removidas.
cbt createfamily your-table cf4
cbt setgcpolicy your-table cf4 maxage=5d and maxversions=2
Neste exemplo, definimos uma política que remove todas as células com mais de 14 dias, exceto a mais recente.
cbt setgcpolicy your-table cf4 maxage=14d and maxversions=1
Go
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Java
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Python
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
C#
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
C++
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Node.js
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
PHP
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Ruby
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
A seção a seguir mostra como criar um grupo de colunas que tenha uma política de coleta de lixo de união.
Console
Para definir uma política de coleta de lixo de união para células em um grupo de colunas:
Abra a lista de instâncias do Bigtable no Console do Google Cloud.
Clique na instância em que estão as tabelas a serem visualizadas.
Clique em Tabelas no painel esquerdo.
A página "Tabelas" exibe uma lista de tabelas na instância.
Clique em Editar
na linha da tabela.Clique em Abrir
ao lado do grupo de colunas que você quer editar.Selecione Política personalizada.
Insira uma regra de coleta de lixo na área de texto, definindo valores para
maxage
e/oumaxversions
. As unidades aceitáveis são: ms, s, m, h e d, que significam milissegundos, segundos, minutos, horas e dias.Por exemplo, para remover células com mais de cinco dias ou que são mais antigas que as duas células mais recentes, digite o seguinte. As células precisam atender a todos os critérios para serem removidas.
maxage=5d or maxversions=2
Clique em Save.
cbt
Neste exemplo, criamos um grupo de colunas chamado cf3
e definimos uma política de
coleta de lixo que remove as células com mais de cinco dias ou
que são mais antigas que as duas células mais recentes. As células precisam atender a qualquer uma das condições
para serem removidas.
cbt createfamily your-table cf3
cbt setgcpolicy your-table cf3 maxage=5d or maxversions=2
Neste exemplo, definimos uma política que remove os valores de todas as células, exceto da mais recente. Ela removerá até mesmo o valor da célula mais recente se ela tiver mais de um segundo de idade.
cbt setgcpolicy your-table cf3 maxversions=1 or maxage=1s
Go
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Java
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Python
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
C#
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
C++
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Node.js
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
PHP
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Ruby
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
A seção a seguir mostra como criar um grupo de colunas que tenha uma política de coleta de lixo de aninhamento. Uma política de coleta de lixo aninhada possui uma combinação de regras de união e intersecção.
Console
Para definir uma política de coleta de lixo de aninhamento para células em um grupo de colunas:
Abra a lista de instâncias do Bigtable no Console do Google Cloud.
Clique na instância em que estão as tabelas a serem visualizadas.
Clique em Tabelas no painel esquerdo.
A página "Tabelas" exibe uma lista de tabelas na instância.
Clique em Editar
na linha da tabela.Clique em Abrir
ao lado do grupo de colunas que você quer editar.Selecione Política personalizada.
Insira uma regra de coleta de lixo na área de texto, definindo valores para
maxage
e/oumaxversions
. As unidades aceitáveis são: ms, s, m, h e d, que significam milissegundos, segundos, minutos, horas e dias.Por exemplo, para manter as duas células mais recentes, mesmo que elas tenham mais de um minuto, ou manter as dez células mais recentes desde que tenham menos de um minuto, digite o seguinte:
(maxage=1m and maxversions=2) or maxversions=10
Clique em Save.
cbt
Neste exemplo, criamos um grupo de colunas chamado cf5
e definimos uma política de
coleta de lixo que remove as células que atendem
a qualquer uma das seguintes condições:
- É mais antiga que as dez células mais recentes.
- Mais de um minuto e mais antigas que as duas células mais recentes
Em outras palavras, essa política mantém as duas células mais recentes, mesmo que tenham mais de um minuto ou tenham as dez células mais recentes, desde que tenham menos de um minuto.
cbt createfamily your-table cf5
cbt setgcpolicy your-table cf5 "(maxage=1m and maxversions=2) or
maxversions=10"
Go
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Java
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Python
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
C#
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
C++
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Node.js
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
PHP
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Ruby
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Atualizar uma política de coleta de lixo
A seção a seguir mostra como modificar uma política de coleta de lixo.
Para aumentar o período de armazenamento de um grupo de colunas em uma tabela que usa replicação, você precisa confirmar o recebimento de um aviso sobre o potencial de seus clusters fiquem dessincronizados. O novo valor não pode ultrapassar 90 dias que o valor atual. Para mais detalhes, consulte Como mudar as políticas com base na idade.
Console
Para atualizar a política de coleta de lixo de um grupo de colunas, siga estas etapas.
Abra a lista de instâncias do Bigtable no Console do Google Cloud.
Clique na instância em que estão as tabelas a serem visualizadas.
Clique em Tabelas no painel esquerdo.
A página "Tabelas" exibe uma lista de tabelas na instância.
Clique em Editar
na linha da tabela.Clique em Abrir
ao lado do grupo de colunas que você quer editar.Clique em Save.
cbt
cbt setgcpolicy your-table cf1 maxage=1d
Se você aumentar o valor de maxage
em uma tabela replicada, use
a sinalização force
opcional. O novo valor não pode ser maior que 90 dias
maior do que o valor atual.
Java
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Python
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
C#
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
C++
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Node.js
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
PHP
Para saber como instalar e usar a biblioteca de cliente do Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Ruby
Para aprender a instalar e usar a biblioteca de cliente para o Bigtable, consulte Bibliotecas de cliente do Bigtable.
Para autenticar no Bigtable, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
A seguir
- Veja outros exemplos de código.
- Explore estratégias para simular o TTL no nível da célula.
- Leia sobre como os carimbos de data/hora que são números sequenciais afetam a coleta de lixo.
- Saiba como manter apenas o valor mais recente de uma coluna.