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
- 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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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.
-
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Enable the Cloud Bigtable and Cloud Bigtable Admin APIs:
gcloud services enable bigtable.googleapis.com
bigtableadmin.googleapis.com -
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.
- Replace
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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.
-
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Enable the Cloud Bigtable and Cloud Bigtable Admin APIs:
gcloud services enable bigtable.googleapis.com
bigtableadmin.googleapis.com -
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.
- Replace
- Execute o comando a seguir para instalar o
CLI
cbt
:gcloud components install cbt
Criar uma instância do Bigtable
Abra a página Criar instância no console do Google Cloud.
Em Nome da instância, insira
Quickstart instance
.Em ID da instância, insira
quickstart-instance
.Clique em Continuar.
Em Tipo de armazenamento, selecione SSD.
Clique em Continuar.
Em ID do cluster, digite
quickstart-instance-c1
.Em Região, selecione uma região perto de você.
Em Zona, selecione Qualquer uma.
Em Modo de escalonamento do nó, escolha Alocação manual.
Em Quantidade, selecione 1.
Clique em Criar para gerar a instância.
conectar-se à instância
Configure a CLI
cbt
para usar o projeto e a instância criando um arquivo.cbtrc
, substituindoPROJECT_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 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.
Crie uma tabela denominada
my-table
.cbt createtable my-table
Liste as tabelas:
cbt ls
O comando exibe uma resposta 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 resposta semelhante a esta:
Family Name GC Policy ----------- --------- cf1 <never>
Escreva os valores
test-value1
etest-value2
na linhar1
usando o grupo de colunascf1
e o qualificador de colunac1
:cbt set my-table r1 cf1:c1=test-value1 cbt set my-table r1 cf1:c1=test-value2
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.
Exclua a tabela
my-table
:cbt deletetable my-table
Exclua a instância:
cbt deleteinstance quickstart-instance
Exclua o arquivo
.cbtrc
.rm ~/.cbtrc
Opcional: revogar credenciais da CLI gcloud:
gcloud auth revoke
A seguir
- Trabalhe com um codelab do Bigtable.
- Consulte a
documentação de referência
da CLI
cbt
. - Consulte o exemplo de código-fonte para um caso de uso de detecção de fraudes.
- Criar um aplicativo Hello World em C#, C++, Go, Java, Node.js, PHP, Python, Ruby ou usando o cliente HBase para Java.