Crie uma tabela de teste:

Esta página descreve as etapas para criar uma pequena tabela do Bigtable que você pode usar 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 , um 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 ter as permissões necessárias para criar uma tabela de teste, peça ao administrador para conceder a você Papel do IAM 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 com papéis personalizados ou outros papéis predefinidos.

Instale o CLI cbt

Execute o comando a seguir para instalar o 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 o CLI cbt para usar seu projeto e instância criando um arquivo .cbtrc, substituindo PROJECT_ID pelo ID para o projeto em que 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 você pode usar CLI cbt com a 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                 @ 2023/09/23-11:44:10.535000
        "true"
      cell_plan:data_plan_05gb                 @ 2023/09/23-11:44:10.535000
        "true"
      stats_summary:connected_cell             @ 2023/09/23-11:44:10.535000
        "1"
      stats_summary:connected_wifi             @ 2023/09/23-11:44:10.535000
        "1"
      stats_summary:os_build                   @ 2023/09/23-11:44:10.535000
        "PQ2A.190405.003"
    ----------------------------------------
    phone#4c410523#20190502
      cell_plan:data_plan_05gb                 @ 2023/09/23-11:44:11.545000
        "true"
      stats_summary:connected_cell             @ 2023/09/23-11:44:11.545000
        "1"
      stats_summary:connected_wifi             @ 2023/09/23-11:44:11.545000
        "1"
      stats_summary:os_build                   @ 2023/09/23-11:44:11.545000
        "PQ2A.190405.004"
    ----------------------------------------
    phone#4c410523#20190505\
      stats_summary:connected_cell             @ 2023/09/23-11:44:12.503000
        "0"
      stats_summary:connected_wifi             @ 2023/09/23-11:44:12.503000
        "1"
      stats_summary:os_build                   @ 2023/09/23-11:44:12.503000
        "PQ2A.190406.000"
    ----------------------------------------
    phone#5c10102#20190501
      cell_plan:data_plan_10gb                 @ 2023/09/23-11:44:13.553000
        "true"
      stats_summary:connected_cell             @ 2023/09/23-11:44:13.553000
        "1"
      stats_summary:connected_wifi             @ 2023/09/23-11:44:13.553000
        "1"
      stats_summary:os_build                   @ 2023/09/23-11:44:13.553000
        "PQ2A.190401.002"
    ----------------------------------------
    tablet#5c10102#20190502
      cell_plan:data_plan_10gb                 @ 2023/09/23-11:44:14.480000
        "true"
      stats_summary:connected_cell             @ 2023/09/23-11:44:14.480000
        "1"
      stats_summary:connected_wifi             @ 2023/09/23-11:44:14.480000
        "0"
      stats_summary:os_build                   @ 2023/09/23-11:44:14.480000
             "PQ2A.190406.000"

  3. Opcional: grave novos valores nas mesmas linhas e colunas. O Bigtable cria novas células com novos carimbos de data/hora para armazenar os novas versões dos dados. Copie os seguintes comandos no seu terminal e pressione Enter.

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

  4. Use o comando cbt read para ler todos os dados da tabela:

       cbt read test_table

    O terminal exibe um resultado semelhante ao seguinte. Cada coluna agora contém duas células com carimbos de data/hora exclusivos.

      ----------------------------------------
  phone#4c410523#20190501
    cell_plan:data_plan_01gb                 @ 2024/07/09-17:48:21.191000
    "true"
    cell_plan:data_plan_01gb                 @ 2024/07/09-17:46:09.369000
    "true"
    cell_plan:data_plan_05gb                 @ 2024/07/09-17:48:21.191000
    "false"
    cell_plan:data_plan_05gb                 @ 2024/07/09-17:46:09.369000
    "true"
    stats_summary:connected_cell             @ 2024/07/09-17:48:21.191000
    "2"
    stats_summary:connected_cell             @ 2024/07/09-17:46:09.369000
    "1"
    stats_summary:connected_wifi             @ 2024/07/09-17:48:21.191000
    "5"
    stats_summary:connected_wifi             @ 2024/07/09-17:46:09.369000
    "1"
    stats_summary:os_build                   @ 2024/07/09-17:48:21.191000
    "PQ2A.190405.003"
    stats_summary:os_build                   @ 2024/07/09-17:46:09.369000
    "PQ2A.190405.003"

  ----------------------------------------
  phone#4c410523#20190502
    cell_plan:data_plan_05gb                 @ 2024/07/09-17:48:22.205000
    "false"
    cell_plan:data_plan_05gb                 @ 2024/07/09-17:46:10.455000
    "true"
    stats_summary:connected_cell             @ 2024/07/09-17:48:22.205000
    "2"
    stats_summary:connected_cell             @ 2024/07/09-17:46:10.455000
    "1"
     stats_summary:connected_wifi             @ 2024/07/09-17:48:22.205000
    "5"
    stats_summary:connected_wifi             @ 2024/07/09-17:46:10.455000
    "1"
    stats_summary:os_build                   @ 2024/07/09-17:48:22.205000
    "PQ2A.190405.004"
    stats_summary:os_build                   @ 2024/07/09-17:46:10.455000
    "PQ2A.190405.004"

  ----------------------------------------
  phone#4c410523#20190505
    stats_summary:connected_cell             @ 2024/07/09-17:48:23.206000
    "1"
    stats_summary:connected_cell             @ 2024/07/09-17:46:11.402000
    "0"
    stats_summary:connected_wifi             @ 2024/07/09-17:48:23.206000
    "4"
    stats_summary:connected_wifi             @ 2024/07/09-17:46:11.402000
    "1"
    stats_summary:os_build                   @ 2024/07/09-17:48:23.206000
    "PQ2A.190406.000"
    stats_summary:os_build                   @ 2024/07/09-17:46:11.402000
    "PQ2A.190406.000"

  ----------------------------------------
  phone#5c10102#20190501
    cell_plan:data_plan_10gb                 @ 2024/07/09-17:48:24.172000
    "false"
    cell_plan:data_plan_10gb                 @ 2024/07/09-17:46:12.388000
    "true"
    stats_summary:connected_cell             @ 2024/07/09-17:48:24.172000
    "3"
    stats_summary:connected_cell             @ 2024/07/09-17:46:12.388000
    "1"
    stats_summary:connected_wifi             @ 2024/07/09-17:48:24.172000
    "3"
    stats_summary:connected_wifi             @ 2024/07/09-17:46:12.388000
    "1"
    stats_summary:os_build                   @ 2024/07/09-17:48:24.172000
    "PQ2A.190401.002"
    stats_summary:os_build                   @ 2024/07/09-17:46:12.388000
    "PQ2A.190401.002"

  ----------------------------------------
  tablet#5c10102#20190502
    cell_plan:data_plan_10gb                 @ 2024/07/09-17:48:25.194000
    "false"
    cell_plan:data_plan_10gb                 @ 2024/07/09-17:46:13.391000
    "true"
    stats_summary:connected_cell             @ 2024/07/09-17:48:25.194000
    "2"
    stats_summary:connected_cell             @ 2024/07/09-17:46:13.391000
    "1"
    stats_summary:connected_wifi             @ 2024/07/09-17:48:25.194000
    "0"
    stats_summary:connected_wifi             @ 2024/07/09-17:46:13.391000
    "0"
    stats_summary:os_build                   @ 2024/07/09-17:48:25.194000
    "PQ2A.190406.000"
    stats_summary:os_build                   @ 2024/07/09-17:46:13.391000
    "PQ2A.190406.000"

Use os dados do teste

Agora você pode usar o test_table no test-instance para testar amostras de código ou consultas.

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