Criar uma instância e gravar dados com o shell do HBase

Guia de início rápido: criar uma instância e gravar dados com o shell do HBase

Criar uma instância e gravar dados com o shell do HBase

Nesta página, você aprenderá a usar o shell do HBase para se conectar a uma instância do Cloud Bigtable, realizar tarefas administrativas básicas, além de ler e gravar dados em uma tabela.

Observação: é possível executar operações do Cloud Bigtable na linha de comando usando o shell do HBase ou a ferramenta cbt. Use o shell do HBase se você estiver acostumado a isso e preferir usá-lo. Caso contrário, recomendamos usar a CLI cbt , que tem menos dependências e etapas de instalação. A CLI cbt é um componente da CLI do Google Cloud.

Se não quiser usar o shell do HBase, siga o guia de início rápido sobre como usar a ferramenta cbt.

Este guia de início rápido usa o Cloud Shell no Console do Google Cloud para executar o shell do HBase. Para melhorar o desempenho, é possível instalar o shell do HBase na máquina.

Antes de começar

1. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

   Importante: o nome que você usa precisa ter entre 4 e 30 caracteres. Quando você digita o nome, o formulário sugere um ID do projeto, que você pode editar. O ID do projeto usado precisa ter entre seis e 30 caracteres, com uma letra minúscula como o primeiro caractere. Você pode usar um traço, uma letra minúscula ou um dígito para os caracteres restantes, mas o último caractere não pode ser um traço. Você precisa estar ciente de que alguns identificadores de recurso, como IDs do projeto, podem ser mantidos além do tempo de vida do seu projeto. Por esse motivo, evite armazenar informações confidenciais em identificadores de recurso.
   Consultar as diretrizes de nomenclatura

2. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como verificar se o faturamento está ativado em um projeto.

3. Ative as APIs Cloud Bigtable and Cloud Bigtable Admin.

   Ative as APIs

Criar uma instância do Bigtable

1. Abra a página "Criar instância" no Console do Google Cloud.

   Abrir a página Criar instância

   

2. Em Nome da instância, digite Quickstart instance.

3. Em ID da instância, insira quickstart-instance.

4. Em Tipo de armazenamento, selecione SSD.

5. Em ID do cluster, digite quickstart-instance-c1.

6. Em Região, selecione us-east1.

7. Em Zona, selecione us-east1-c.

8. Clique em Criar para criar a instância.

Conectar-se à instância

1. Abra uma janela de terminal no Cloud Shell.

   Abrir no Cloud Shell

2. Para usar o shell do HBase com o cliente HBase para Java do Cloud Bigtable, instale um ambiente de execução Java 8. Outras versões do Java não são compatíveis. Instale e configure o ambiente Java 8 executando os seguintes comandos:

   sudo apt-get update
   sudo apt-get install openjdk-8-jdk-headless
   export JAVA_HOME=$(update-alternatives --list java | tail -1 | sed -E 's/\/bin\/java//')

3. Clone o repositório que contém os arquivos de shell do HBase e altere para o diretório do shell do HBase:

   git clone https://github.com/GoogleCloudPlatform/cloud-bigtable-examples.git
   cd cloud-bigtable-examples/quickstart

   Observação: antes de executar ./quickstart.sh, verifique se você não tem um arquivo hbase-site.xml configurado.

4. Inicie o shell do HBase:

   ./quickstart.sh

   Observação: se for solicitado um ID de instância, digite o número ao lado de quickstart-instance e pressione Enter.

Agora você está conectado!

Ler e gravar dados

O Bigtable armazena dados em tabelas com linhas. Cada linha é identificada por uma chave de linha.

Os dados em uma linha são organizados em famílias de colunas, que são grupos de colunas. Um qualificador de coluna identifica uma única coluna em um grupo de colunas.

Pode haver várias células com carimbo de data/hora na interseção de uma linha e uma coluna.

1. Crie uma tabela denominada my-table, com um grupo de colunas denominado cf1:

   create 'my-table', 'cf1'
   

   O shell exibirá uma resposta semelhante a esta:

   0 row(s) in 1.5210 seconds
   
   => Hbase::Table - my-table
   

2. Liste as tabelas:

   list
   

   O shell exibirá uma resposta semelhante a esta:

   TABLE
   my-table
   1 row(s) in 1.3580 seconds
   
   => ["my-table"]
   

3. Coloque o valor test-value na linha r1 usando o grupo de colunas cf1 e o qualificador de coluna c1:

   put 'my-table', 'r1', 'cf1:c1', 'test-value'
   

4. Use o comando scan para fazer a verificação da tabela e ler os dados adicionados:

   scan 'my-table'
   

   O shell exibirá uma resposta semelhante a esta:

   ROW      COLUMN+CELL
    r1      column=cf1:c1, timestamp=1430687836046, value=test-value
   1 row(s) in 0.6260 seconds
   

5. Excluir a tabela my-table:

   disable 'my-table'
   drop 'my-table'
   

6. Digite exit e pressione Enter para sair do shell do HBase. Depois que você sair, serão exibidas várias mensagens de registro, o que é normal.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.

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

   Abrir a lista de instâncias

2. Clique em Quickstart instance.
3. Clique em Excluir instância.

   

4. Digite quickstart-instance e clique em Excluir para excluir a instância.

A seguir

• Trabalhe com um codelab do Bigtable.
• Veja exemplos de código.
• Consulte o exemplo de código-fonte para um caso de uso de detecção de fraudes.
• Criar um aplicativo Hello World em C#, C++, Go, Java, Node.js, PHP, Python, Ruby ou usando o cliente HBase para Java.