Criar uma instância e gravar dados com a CLI cbt

Se estiver aprendendo sobre o Bigtable, confira um guia de início rápido para conhecer os princípios básicos que você usaria em reduzir escalonamento horizontal uma produção de nuvem.

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

  • Conecte a uma instância do Bigtable.
  • realiza tarefas administrativas básicas;
  • grava dados em uma tabela;
  • lê dados de uma tabela.

Antes de começar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. Install the Google Cloud CLI.
  3. To initialize the gcloud CLI, run the following command:

    gcloud init
  4. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

  5. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  6. Enable the Cloud Bigtable and Cloud Bigtable Admin APIs:

    gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com
  7. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/bigtable.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="USER_IDENTIFIER" --role=ROLE
    • Replace PROJECT_ID with your project ID.
    • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:myemail@example.com.

    • Replace ROLE with each individual role.
  8. Install the Google Cloud CLI.
  9. To initialize the gcloud CLI, run the following command:

    gcloud init
  10. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

  11. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  12. Enable the Cloud Bigtable and Cloud Bigtable Admin APIs:

    gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com
  13. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/bigtable.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="USER_IDENTIFIER" --role=ROLE
    • Replace PROJECT_ID with your project ID.
    • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:myemail@example.com.

    • Replace ROLE with each individual role.
  14. Execute o comando a seguir para instalar o CLI cbt :
    gcloud components install cbt

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. Clique em Continuar.

  5. Em Tipo de armazenamento, selecione SSD.

  6. Clique em Continuar.

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

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

  9. Em Zona, selecione Qualquer uma.

  10. Em Modo de escalonamento do nó, escolha Alocação manual.

  11. Em Quantidade, selecione 1.

  12. Clique em Criar para gerar a instância.

conectar-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 = 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 CLI 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 células com carimbo de data/hora na interseção de uma linha e uma coluna.

  1. Crie uma tabela denominada my-table.

    cbt createtable my-table
  2. Liste as tabelas:

    cbt ls

    O comando exibe uma resposta 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 resposta semelhante a esta:

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

  5. Escreva os valores test-value1 e test-value2 na linha r1 usando o grupo de colunas cf1 e o qualificador de coluna c1:

    cbt set my-table r1 cf1:c1=test-value1
      cbt set my-table r1 cf1:c1=test-value2
    
  6. Use o comando cbt read para ler os dados que você adicionou à tabela:

    cbt read my-table

    O shell exibirá uma resposta semelhante a esta:

        ----------------------------------------
        r1
          cf1:c1                                   @ 2023/03/22-06:56:11.323000
            "test-value1"
          cf1:c1                                   @ 2023/03/22-06:56:04.361000
            "test-value2"

    Dois valores com carimbo de data/hora são armazenados para a mesma coluna na linha r1.

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

  4. Opcional: revogar credenciais da CLI gcloud:

    gcloud auth revoke

A seguir