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.

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.

Antes de começar

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  4. Ative as APIs Cloud Bigtable, Cloud Bigtable Admin.

    Ative as APIs

  5. Crie uma conta de serviço:

    1. No Console do Cloud, acesse a página Criar conta de serviço.

      Acesse Criar conta de serviço
    2. Selecione um projeto.
    3. No campo Nome da conta de serviço, insira um nome. O Console do Cloud preenche o campo ID da conta de serviço com base nesse nome.

      No campo Descrição da conta de serviço, insira uma descrição. Por exemplo, Service account for quickstart.

    4. Clique em Criar e continuar.
    5. Clique no campo Selecionar um papel e clique em Bigtable Administrator.

    6. Clique em Continuar.
    7. Clique em Concluído para terminar a criação da conta de serviço.

      Não feche a janela do navegador. Você vai usá-lo na próxima etapa.

  6. Crie uma chave de conta de serviço:

    1. No Console do Cloud, clique no endereço de e-mail da conta de serviço que você criou.
    2. Clique em Chaves.
    3. Clique em Adicionar chave e em Criar nova chave.
    4. Clique em Criar. O download de um arquivo de chave JSON é feito no seu computador.
    5. Clique em Fechar.
  7. Instale e inicialize o SDK do Cloud..
  8. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  9. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  10. Ative as APIs Cloud Bigtable, Cloud Bigtable Admin.

    Ative as APIs

  11. Crie uma conta de serviço:

    1. No Console do Cloud, acesse a página Criar conta de serviço.

      Acesse Criar conta de serviço
    2. Selecione um projeto.
    3. No campo Nome da conta de serviço, insira um nome. O Console do Cloud preenche o campo ID da conta de serviço com base nesse nome.

      No campo Descrição da conta de serviço, insira uma descrição. Por exemplo, Service account for quickstart.

    4. Clique em Criar e continuar.
    5. Clique no campo Selecionar um papel e clique em Bigtable Administrator.

    6. Clique em Continuar.
    7. Clique em Concluído para terminar a criação da conta de serviço.

      Não feche a janela do navegador. Você vai usá-lo na próxima etapa.

  12. Crie uma chave de conta de serviço:

    1. No Console do Cloud, clique no endereço de e-mail da conta de serviço que você criou.
    2. Clique em Chaves.
    3. Clique em Adicionar chave e em Criar nova chave.
    4. Clique em Criar. O download de um arquivo de chave JSON é feito no seu computador.
    5. Clique em Fechar.
  13. Instale e inicialize o SDK do Cloud..

Criar uma instância do Bigtable

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

    Criar uma instância

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

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

  4. Em Tipo de armazenamento, selecione SSD.

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

  6. Em Região, selecione uma região perto de você.

  7. Em Zona, selecione uma zona na região selecionada.

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

Conecte-se à instância

  1. 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

  2. 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.

  1. Crie uma tabela denominada my-table.

       cbt createtable my-table

  2. Liste as tabelas:

       cbt ls

    O comando exibe uma saída semelhante a esta:

        my-table

  3. Adicione um grupo de colunas denominado cf1:

       cbt createfamily my-table cf1

  4. Liste os grupos de colunas:

       cbt ls my-table

    O comando exibe uma saída semelhante a esta:

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

  5. 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

  6. 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.

  1. Exclua a tabela my-table:

       cbt deletetable my-table

  2. Exclua a instância:

       cbt deleteinstance quickstart-instance
  3. Exclua o arquivo .cbtrc.

       rm ~/.cbtrc