Crie uma tabela de teste:

Nesta página, descrevemos as etapas para criar uma pequena tabela do Bigtable que pode ser usada para testar snippets de código. A tabela contém dados de séries temporais para smartphones e tablets.

Essas instruções usam o console do Google Cloud e a CLI cbt, uma interface de linha de comando criada especificamente para o Bigtable.

Antes de começar

Antes de criar uma tabela de teste, atenda aos seguintes pré-requisitos.

Configurar a autenticação

É possível usar as amostras da CLI do gcloud nesta página de um dos seguintes ambientes de desenvolvimento:

  • Cloud Shell: para usar um terminal on-line com a CLI gcloud já configurada, ative o Cloud Shell.

    Na parte de baixo desta página, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. A inicialização da sessão pode levar alguns segundos.

  • Shell local: para usar a CLI da gcloud em um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud.

Para informações sobre como configurar a autenticação para um ambiente de produção, consulte Configure o Application Default Credentials para o código em execução no Google Cloud.

Conceder papel do IAM

Para receber as permissões necessárias para criar uma tabela de teste, peça ao administrador para conceder a você o papel do IAM de Administrador do Bigtable (roles/bigtable.admin) no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Instale a CLI cbt

Execute o seguinte comando para instalar a CLI cbt :

  gcloud components install cbt

criar uma instância

No projeto escolhido, crie uma instância de teste para armazenar a tabela de teste. Como a tabela é pequena, você só precisa de uma instância de nó único.

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

    Criar uma instância

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

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

  4. Em Tipo de armazenamento, selecione SSD.

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

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

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

  8. Em Nós, digite 1.

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

Conecte-se à instância

  1. Configure a CLI 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 = test-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 = test-instance

    Agora, é possível usar a CLI cbt com sua instância.

Crie uma tabela de teste:

  1. Crie uma tabela chamada test-table que tenha dois grupos de colunas. Para cada grupo de colunas, defina uma política de coleta de lixo para manter no máximo duas células por coluna:

       cbt createtable test-table "families=stats_summary:maxversions=2,stats_detail:maxversions=2,cell_plan:maxversions=2"

  2. Liste os grupos de colunas:

       cbt ls test-table

    O terminal exibe um resultado semelhante ao seguinte:

        Family Name       GC Policy
    -----------       ---------
    stats_detail        versions() > 2
    stats_summary       versions() > 2
    cell_plan           versions() > 2

Preencher a tabela

  1. Copie os seguintes comandos na janela do terminal e pressione Enter.

       cbt set test-table phone#4c410523#20190501 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190405.003 cell_plan:data_plan_01gb=true cell_plan:data_plan_05gb=true
    cbt set test-table phone#4c410523#20190502 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190405.004 cell_plan:data_plan_05gb=true
    cbt set test-table phone#4c410523#20190505 stats_summary:connected_cell=0 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190406.000
    cbt set test-table phone#5c10102#20190501 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190401.002 cell_plan:data_plan_10gb=true
    cbt set test-table tablet#5c10102#20190502 stats_summary:connected_cell=1 stats_summary:connected_wifi=0 stats_summary:os_build=PQ2A.190406.000 cell_plan:data_plan_10gb=true

  2. Use o comando cbt read para ler os dados que você adicionou à tabela:

       cbt read test-table

    O terminal exibe um resultado semelhante ao seguinte. Observe que os carimbos de data/hora são atribuídos automaticamente às células porque sua solicitação de gravação não inclui carimbos de data/hora.

        ----------------------------------------
    phone#4c410523#20190501
      cell_plan:data_plan_01gb                 @ 2020/09/23-11:44:10.535000
        "true"
      cell_plan:data_plan_05gb                 @ 2020/09/23-11:44:10.535000
        "true"
      stats_summary:connected_cell             @ 2020/09/23-11:44:10.535000
        "1"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:10.535000
        "1"
      stats_summary:os_build                   @ 2020/09/23-11:44:10.535000
        "PQ2A.190405.003"
    ----------------------------------------
    phone#4c410523#20190502
      cell_plan:data_plan_05gb                 @ 2020/09/23-11:44:11.545000
        "true"
      stats_summary:connected_cell             @ 2020/09/23-11:44:11.545000
        "1"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:11.545000
        "1"
      stats_summary:os_build                   @ 2020/09/23-11:44:11.545000
        "PQ2A.190405.004"
    ----------------------------------------
    phone#4c410523#20190505
    
      stats_summary:connected_cell             @ 2020/09/23-11:44:12.503000
        "0"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:12.503000
        "1"
      stats_summary:os_build                   @ 2020/09/23-11:44:12.503000
        "PQ2A.190406.000"
    ----------------------------------------
    phone#5c10102#20190501
      cell_plan:data_plan_10gb                 @ 2020/09/23-11:44:13.553000
        "true"
      stats_summary:connected_cell             @ 2020/09/23-11:44:13.553000
        "1"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:13.553000
        "1"
      stats_summary:os_build                   @ 2020/09/23-11:44:13.553000
        "PQ2A.190401.002"
    ----------------------------------------
    tablet#5c10102#20190502
      cell_plan:data_plan_10gb                 @ 2020/09/23-11:44:14.480000
        "true"
      stats_summary:connected_cell             @ 2020/09/23-11:44:14.480000
        "1"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:14.480000
        "0"
      stats_summary:os_build                   @ 2020/09/23-11:44:14.480000
             "PQ2A.190406.000"

Use os dados do teste

Agora é possível usar test-table no test-instance para testar snippets de código, como os encontrados em Como usar o Bigtable com o Cloud Functions.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos criados durante essas etapas, exclua a instância assim que você terminar o teste. Ao excluir o arquivo .cbtrc, você estará pronto para trabalhar em um projeto diferente.

  1. Se quiser manter a instância, mas excluir a tabela, use o comando deletetable:

       cbt deletetable test-table

  2. Se você não planeja usar a instância para fazer outros testes, exclua a instância. Essa ação também exclui a tabela.

       cbt deleteinstance test-instance

  3. Exclua o arquivo .cbtrc:

       rm ~/.cbtrc

A seguir