Configurar fluxo de alterações

Para rastrear alterações de dados feitas em uma tabela do Bigtable, ative um fluxo de alterações para a tabela e leia-o usando um aplicativo como o Dataflow. Antes de ler este documento, leia a Visão geral do fluxo de alterações. Lembre-se sobretudo dos custos gerados ao usar o fluxo de alterações.

Nesta página, descrevemos como ativar, desativar e alterar o período de armazenamento de um fluxo de alterações.

Para instruções sobre como criar uma nova tabela com um fluxo de alterações ativado, consulte Criar uma tabela.

Papel necessário

Para receber as permissões necessárias para ativar, desativar ou modificar um fluxo de alterações do Bigtable, peça ao administrador para conceder a você o seguinte papel do IAM.

• Administrador do Bigtable (roles/bigtable.admin) na instância do Bigtable que contém a tabela com as alterações que você pretende mostrar

Ativar um fluxo de alterações

Para ativar um fluxo de alterações em uma tabela, siga estas etapas:

Console

1. Abra a lista de instâncias do Bigtable no console do Google Cloud.

   Abrir a lista de instâncias

2. Clique na instância que contém a tabela em que você quer ativar um fluxo de alterações.

3. Clique em Tabelas no painel esquerdo.

   A página "Tabelas" exibe uma lista de tabelas na instância.

4. Clique em Editar na tabela em que você quer ativar o fluxo de alterações.

5. Clique em Ativar fluxo de alterações.

6. No campo Prazo de validade, digite um número entre 1 e 7 para configurar por quantos dias os registros do fluxo de dados serão retidos.

7. Clique em Save.

gcloud

Para ativar um fluxo de alterações em uma tabela, use o 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

Substitua:

• TABLE_ID: o ID da tabela com as alterações que você quer mostrar.
• INSTANCE_ID: a instância que contém a tabela.
• PROJECT_ID: o projeto que contém a instância
• CHANGE_STREAM_RETENTION_PERIOD: o período em que o Bigtable manterá os dados do fluxo de alterações da tabela. Precisa ser no mínimo um dia e no máximo sete dias, expresso pelo número e pela letra da unidade. As unidades aceitáveis são dias (d), horas (h), minutos (m) e segundos (s). Exemplo: 5d

Desativar um fluxo de alterações

É possível desativar o fluxo de alterações de uma tabela a qualquer momento. Os registros do fluxo de dados que foram criados antes de desativar o fluxo de alterações continuarão a consumir armazenamento até a próxima compactação, mas não haverá mais cobrança por esse armazenamento. Não é possível ler um fluxo de alterações após a desativação, incluindo as alterações registradas antes de desativar o fluxo.

Console

1. Abra a lista de instâncias do Bigtable no console do Google Cloud.

   Abrir a lista de instâncias

2. Clique na instância em que estão as tabelas a serem visualizadas.

3. Clique em Tabelas no painel esquerdo.

   A página "Tabelas" exibe uma lista de tabelas na instância.

4. Clique em Editar na tabela com a configuração do fluxo de alterações que você quer desativar.

5. Desmarque a caixa de seleção Ativar fluxo de alterações.

6. Clique em Save.

gcloud

Para desativar um fluxo de alterações em uma tabela, use o comando gcloud bigtable instances tables update.

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --clear-change-stream-retention-period

Substitua:

• TABLE_ID: o ID da tabela com as alterações que você quer mostrar.
• INSTANCE_ID: a instância que contém a tabela.
• PROJECT_ID: o projeto que contém a instância

Modificar o tempo de retenção de um fluxo de alterações

É possível modificar por quantos dias o Bigtable manterá os registros do fluxo de alterações. Se você reduzir o número de dias, os registros que foram mostrados antes de alterar a configuração continuarão consumindo armazenamento até a próxima compactação. Depois de alterar a configuração, só será possível mostrar as alterações do período recém-especificado.

Se você aumentar o tempo de retenção, ele não será retroativo. O fluxo de alterações será mantido pelo número de dias aumentado a partir do momento em que você modificar a configuração.

Console

1. Abra a lista de instâncias do Bigtable no console do Google Cloud.

   Abrir a lista de instâncias

2. Clique na instância em que estão as tabelas a serem visualizadas.

3. Clique em Tabelas no painel esquerdo.

   A página "Tabelas" exibe uma lista de tabelas na instância.

4. Clique em Editar na tabela com a configuração do fluxo de alterações que você quer modificar.

5. No campo "Prazo de validade", digite um número entre 1 e 7 referente a quantos dias os registros do fluxo de dados serão retidos.

6. Clique em Save.

gcloud

Para alterar o período de armazenamento do fluxo de alterações de uma tabela, use o 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

Substitua:

• TABLE_ID: o ID da tabela com as alterações que você quer mostrar.
• INSTANCE_ID: a instância que contém a tabela.
• PROJECT_ID: o projeto que contém a instância
• CHANGE_STREAM_RETENTION_PERIOD: o período em que o Bigtable manterá os dados do fluxo de alterações da tabela. Precisa ser de um a sete dias, expresso pelo número e pela letra da unidade. As unidades aceitáveis são dias (d), horas (h), minutos (m) e segundos (s). Exemplo: 5d

A seguir

• Leia um fluxo de alterações com o Dataflow.
• Confira os preços do Bigtable.
• Conclua um guia de início rápido para saber como ativar um fluxo de alterações e ver as mudanças.
• Usar a biblioteca de cliente do Cloud Bigtable para Java para ler fluxos de alterações
• Siga um tutorial sobre o processamento de um fluxo de alterações.