Este exemplo é um aplicativo "Hello World" muito simples, escrito em Python, que ilustra como:
- conectar-se a uma instância do Cloud Bigtable;
- Criação de uma nova tabela
- Gravação de dados na tabela
- Leitura dos dados
- Exclusão da tabela
Como executar a amostra
Neste exemplo, mostramos o uso do pacote do Cloud Bigtable da biblioteca de cliente do Google Cloud para Python na comunicação com o Cloud Bigtable. O pacote do Cloud Bigtable é a melhor opção para novos aplicativos. Se você precisar mover uma carga de trabalho atual do HBase para o Cloud Bigtable, veja o exemplo do "Hello World" que usa o pacote do HappyBase.
Para executar este programa de amostra, siga as instruções do exemplo no GitHub.
Como usar a biblioteca de cliente do Google Cloud com o Cloud Bigtable
O aplicativo de amostra conecta-se ao Cloud Bigtable e demonstra algumas operações simples.
Como instalar e importar a biblioteca de cliente
Use o PIP para instalar os pacotes em Python, necessários em um ambiente virtualenv. A amostra inclui um arquivo de requisitos que define os pacotes necessários.
Importe os módulos.
Como conectar ao Cloud Bigtable
Conecte-se ao Cloud Bigtable usando um
bigtable.Client
.
Como criar uma tabela
Instancie um objeto de tabela usando Instance.table()
. Crie um grupo de colunas e defina a
política de coleta de lixo. Em seguida, passe o grupo de colunas para Table.create()
a fim de criar a tabela.
Como gravar linhas em uma tabela
Execute um loop em uma lista de strings de saudação para criar algumas linhas novas na tabela.
Em cada iteração, use Table.row()
para definir uma linha
e atribuir a ela uma chave de linha. Chame Row.set_cell()
para definir o valor da célula atual e anexe a nova linha a uma matriz.
Por fim, chame Table.mutate_rows()
para adicionar
as linhas à tabela.
Como criar um filtro
Antes de ler os dados gravados, crie um filtro usando row_filters.CellsColumnLimitFilter()
para limitar os dados
retornados pelo Cloud Bigtable. Com esse filtro, o Cloud Bigtable
retornará apenas a versão mais recente de cada valor, mesmo que a tabela
contenha versões mais antigas que não tenham sido coletadas como lixo.
Como ler uma linha pela respectiva chave
Chame o método Table.read_row()
da tabela para receber uma
referência da linha com uma chave de linha específica,
transmitindo-a chave e o filtro, a fim de receber uma versão de cada valor naquela linha.
Como verificar todas as linhas da tabela
Use Table.read_rows()
para ler um intervalo de linhas
de uma tabela.
Como excluir tabelas
Exclua uma tabela com Table.delete()
.
Funcionamento em conjunto
Aqui está o exemplo completo sem comentários.