Guia de início rápido sobre como usar a ferramenta cbt

Se você estiver conhecendo o Cloud Bigtable, leia um guia de início rápido para saber sobre os conceitos básicos que usaria em grande escala em um ambiente de produção.

Observação: é possível executar operações do 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 ferramenta cbt, que tem menos dependências e etapas de instalação. A ferramenta cbt é um componente do SDK do Google Cloud.

Neste guia de início rápido, usamos a ferramenta de linha de comando cbt. Se você preferir usar o shell do HBase, siga o Guia de início rápido sobre como usar o shell do HBase.

Neste guia de início rápido, você realiza as seguintes ações:

conecta-se a uma instância do Cloud Bigtable;
realiza tarefas administrativas básicas;
grava dados em uma tabela;
lê dados de uma tabela.

É possível trilhar este guia de início rápido usando o Cloud Shell ou sua janela de terminal local.

Selecione ou crie um projeto do GCP. Se você não pretende manter os recursos criados neste guia de início rápido, crie um projeto novo. Depois de concluir o início rápido, exclua o projeto.

Acessar a página do seletor de projetos

Importante: o nome do projeto precisa ter entre 4 e 30 caracteres. Quando você digita o nome, o formulário sugere um ID do projeto, que pode ser editado. O ID do projeto precisa ter entre 6 e 30 caracteres, com uma letra minúscula como primeiro caractere. O último caractere não pode ser um hífen. Os identificadores de projeto podem ser mantidos por mais tempo que os projetos, portanto, não use informações confidenciais como nome ou ID do projeto.
Verifique se o faturamento está ativado para o projeto do Google Cloud. Saiba como confirmar se o faturamento está ativado para o projeto.
Ative as APIs Bigtable e Bigtable Admin.

Ativar as APIs
Depois de ativar as APIs, clique em Acessar credenciais.
Na página Credenciais, responda às perguntas necessárias:
1. Em resposta a "Qual API você usa?", escolha API Cloud Bigtable.
2. Responda à pergunta sobre o App Engine ou Compute Engine. Para este guia de início rápido, você não os usará.
3. Clique em Preciso de quais credenciais?
4. Se for solicitado que você crie uma conta de serviço, forneça as seguintes informações:
  1. Escolha um nome para sua conta de serviço.
  2. Em Papel, escolha Cloud Bigtable > Administrador do Bigtable.
  3. Em Tipo de chave, selecione JSON.
  4. Clique em Continuar.
  5. Salve o arquivo JSON da chave da conta de serviço recém-criada no diretório HOME local ou na sua preferência. Você pode pular esta etapa se planeja concluir o guia de início rápido no Cloud Shell.
5. Se você não for solicitado a criar uma nova conta de serviço, clique em Concluído.
Abra uma janela de terminal localmente ou com o Cloud Shell:

Abra o Cloud Shell
Se você estiver usando a janela de terminal local, defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS. Substitua [PATH] pelo caminho do arquivo JSON com a chave da conta de serviço.
```
   export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"
```
Exemplo:
```
   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/my-key.json"
```
Se você estiver usando sua janela de terminal local e não tiver instalado anteriormente o SDK do Cloud e a ferramenta cbt, faça isso agora. Se você estiver usando o Cloud Shell, essas ferramentas estão pré-instaladas, então ignore essas etapas.
1. Instale o SDK do Cloud.
2. Instale a ferramenta de linha de comando cbt:
```
gcloud components update
gcloud components install cbt
```

Criar uma instância do Bigtable

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

Criar uma instância
Em Nome da instância, insira Quickstart instance.
Em ID da instância, insira quickstart-instance.
Em Tipo de armazenamento, selecione SSD.
Em ID do cluster, insira quickstart-instance-c1.
Em Região, selecione uma região perto de você.
Em Zona, selecione uma zona na região selecionada.
Clique em Criar para criar a instância.

Conecte-se à instância

Configure cbt para usar o projeto e a instância criando um arquivo .cbtrc, substituindo project-id pelo ID do projeto em que você criou a instância do Bigtable:
```
   echo project = project-id > ~/.cbtrc
   echo instance = quickstart-instance >> ~/.cbtrc
```
Verifique se você configurou o arquivo .cbtrc corretamente:
```
   cat ~/.cbtrc
```
O terminal exibe o conteúdo do arquivo .cbtrc, que é semelhante ao seguinte:
```
project = project-id
instance = quickstart-instance
```
Agora, é possível usar a ferramenta cbt com sua instância.

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 versões com carimbo de data/hora do valor na interseção de uma linha e uma coluna. Cada versão é chamada de célula.

Crie uma tabela denominada my-table.
```
   cbt createtable my-table
```
Liste as tabelas:
```
   cbt ls
```
O comando exibe uma saída semelhante a esta:
```
    my-table
```
Adicione um grupo de colunas denominado cf1:
```
   cbt createfamily my-table cf1
```

Liste os grupos de colunas:

   cbt ls my-table

O comando exibe uma saída semelhante a esta:

    Family Name     GC Policy
    -----------     ---------
    cf1             <never>

Coloque o valor test-value na linha r1, usando o grupo de colunas cf1 e o qualificador de coluna c1:
```
   cbt set my-table r1 cf1:c1=test-value
```
Observação: neste guia de início rápido, você só define uma célula, mas o Bigtable permite configurar até dez mil células em uma única solicitação de gravação.
Use o comando cbt read para ler os dados que você adicionou à tabela:
```
   cbt read my-table
```
O shell exibirá uma saída semelhante a esta:
```
    ----------------------------------------
    r1
      cf1:c1                                   @ 2019/11/26-15:05:38.840000
        "test-value"
```
Um carimbo de data/hora é adicionado automaticamente porque você não especificou nenhum.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste guia de início rápido, exclua a instância. Com a exclusão do arquivo .cbtrc, você está pronto para trabalhar em outro projeto.

Exclua a tabela my-table:
```
   cbt deletetable my-table
```

Exclua a instância:

   cbt deleteinstance quickstart-instance

Exclua o arquivo .cbtrc.
```
   rm ~/.cbtrc
```