GSP1048

Visão geral

O Cloud Spanner é o serviço de banco de dados relacional do Google, totalmente gerenciado e com capacidade de escala horizontal. Ele costuma ser usado para a execução de cargas de trabalho mais exigentes, em que a consistência e a disponibilidade em escala são essenciais. Clientes de diversos setores, como serviços financeiros, jogos e varejo, entre outros, já usam o Spanner.

Neste laboratório, você vai aprender a executar tarefas administrativas básicas em uma instância do Cloud Spanner.

Atividade prática

Neste laboratório, você aprenderá as seguintes funções:

• Criar uma instância
• Cria um banco de dados
• Criar tabelas
• Inserir e modificar dados
• Usar a CLI do Google Cloud com o Cloud Spanner
• Usar ferramentas de automação com o Cloud Spanner
• Excluir uma instância

Configuração e requisitos

Antes de clicar no botão Começar o Laboratório

Leia estas instruções. Os laboratórios são cronometrados e não podem ser pausados. O timer é ativado quando você clica em Iniciar laboratório e mostra por quanto tempo os recursos do Google Cloud vão ficar disponíveis.

Este laboratório prático permite que você realize as atividades em um ambiente real de nuvem, e não em uma simulação ou demonstração. Você vai receber novas credenciais temporárias para fazer login e acessar o Google Cloud durante o laboratório.

Confira os requisitos para concluir o laboratório:

• Acesso a um navegador de Internet padrão (recomendamos o Chrome).

Observação: para executar este laboratório, use o modo de navegação anônima (recomendado) ou uma janela anônima do navegador. Isso evita conflitos entre sua conta pessoal e de estudante, o que poderia causar cobranças extras na sua conta pessoal.

• Tempo para concluir o laboratório: não se esqueça que, depois de começar, não será possível pausar o laboratório.

Observação: use apenas a conta de estudante neste laboratório. Se usar outra conta do Google Cloud, você poderá receber cobranças nela.

Como iniciar seu laboratório e fazer login no console do Google Cloud

1. Clique no botão Começar o laboratório. Se for preciso pagar por ele, uma caixa de diálogo vai aparecer para você selecionar a forma de pagamento. No painel Detalhes do Laboratório, à esquerda, você vai encontrar o seguinte:

   • O botão Abrir Console do Google Cloud
   • O tempo restante
   • As credenciais temporárias que você vai usar neste laboratório
   • Outras informações, se forem necessárias

2. Se você estiver usando o navegador Chrome, clique em Abrir console do Google Cloud ou clique com o botão direito do mouse e selecione Abrir link em uma janela anônima.

   O laboratório ativa os recursos e depois abre a página Fazer Login em outra guia.

   Dica: coloque as guias em janelas separadas lado a lado.

   Observação: se aparecer a caixa de diálogo Escolher uma conta, clique em Usar outra conta.

3. Se necessário, copie o Nome de usuário abaixo e cole na caixa de diálogo Fazer login.

   {{{user_0.username | "Username"}}}

   Você também encontra o nome de usuário no painel Detalhes do Laboratório.

4. Clique em Próxima.

5. Copie a Senha abaixo e cole na caixa de diálogo de Olá.

   {{{user_0.password | "Password"}}}

   Você também encontra a senha no painel Detalhes do Laboratório.

6. Clique em Próxima.

   Importante: você precisa usar as credenciais fornecidas no laboratório, e não as da sua conta do Google Cloud. Observação: se você usar sua própria conta do Google Cloud neste laboratório, é possível que receba cobranças adicionais.

7. Acesse as próximas páginas:

   • Aceite os Termos e Condições.
   • Não adicione opções de recuperação nem autenticação de dois fatores (porque essa é uma conta temporária).
   • Não se inscreva em testes gratuitos.

Depois de alguns instantes, o console do Google Cloud será aberto nesta guia.

Observação: para acessar os produtos e serviços do Google Cloud, clique no Menu de navegação ou digite o nome do serviço ou produto no campo Pesquisar.

Ativar o Cloud Shell

O Cloud Shell é uma máquina virtual com várias ferramentas de desenvolvimento. Ele tem um diretório principal permanente de 5 GB e é executado no Google Cloud. O Cloud Shell oferece acesso de linha de comando aos recursos do Google Cloud.

1. Clique em Ativar o Cloud Shell na parte de cima do console do Google Cloud.

2. Clique nas seguintes janelas:

   • Continue na janela de informações do Cloud Shell.
   • Autorize o Cloud Shell a usar suas credenciais para fazer chamadas de APIs do Google Cloud.

Depois de se conectar, você verá que sua conta já está autenticada e que o projeto está configurado com seu Project_ID, . A saída contém uma linha que declara o projeto PROJECT_ID para esta sessão:

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

A gcloud é a ferramenta de linha de comando do Google Cloud. Ela vem pré-instalada no Cloud Shell e aceita preenchimento com tabulação.

3. (Opcional) É possível listar o nome da conta ativa usando este comando:

gcloud auth list

4. Clique em Autorizar.

Saída:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (Opcional) É possível listar o ID do projeto usando este comando:

gcloud config list project

Saída:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Observação: consulte a documentação completa da gcloud no Google Cloud no guia de visão geral da gcloud CLI.

Tarefa 1: criar uma instância

1. O primeiro passo para usar o Cloud Spanner é criar uma instância. Uma instância é nada mais que uma alocação de recursos de computação e armazenamento do Google Cloud. No console, abra o menu de navegação () > Ver todos os produtos. Na seção Bancos de dados, clique em Spanner.

2. Caso apareça alguma janela de confirmação ou informação extra, aceite para continuar.

3. Em seguida, clique em Criar uma instância provisionada.

4. Preencha os campos a seguir e deixe os demais com os valores padrão:

Item	Valor
Selecione uma edição	Empresa
Nome da instância	banking-instance
Selecione uma configuração
Configurar capacidade de computação	Unidade: nós // Quantidade: 1

5. Clique em Criar. Agora, é só entrar na página de detalhes da instância para acessá-la. Aqui, você vai ver um panorama de como a instância está funcionando, a utilização etc. A próxima etapa é criar um banco de dados.

Tarefa 2: criar um banco de dados

1. Na página de detalhes da instância, clique em Criar banco de dados.

2. Para o nome do banco de dados, digite example-db.

3. Ignore a etapa Definir seu esquema (opcional) por enquanto. Você verá como definir o esquema na próxima seção.

4. Clique em Criar.

5. Você vai entrar na página Visão geral do banco de dados que acabou de criar. A página é parecida com a da instância, mas as estatísticas se referem especificamente a esse banco de dados. Observe também, que haverá novas opções no menu à esquerda.

6. Clique em Verificar meu progresso para conferir a conclusão desta etapa.

Criar uma instância e um banco de dados

Tarefa 3: criar uma tabela no seu banco de dados

1. Na página de detalhes do banco de dados que você criou, banking-db, role a página para baixo e clique em Criar tabela.

2. Clique no ícone + azul para abrir a página Consulta e insira o comando a seguir:

CREATE TABLE Customer ( CustomerId STRING(36) NOT NULL, Name STRING(MAX) NOT NULL, Location STRING(MAX) NOT NULL, ) PRIMARY KEY (CustomerId);

3. Clique em Executar.

4. Quando a operação for concluída, clique em Visão geral e então em Banco de dados, no menu à esquerda. Role para baixo até Tabelas e clique em Cliente para ver os detalhes do esquema:

5. Clique em Verificar meu progresso para conferir a conclusão desta etapa.

Criar um esquema para o banco de dados

Tarefa 4: inserir e modificar dados

O Console do Cloud tem uma interface para inserir, editar e excluir dados.

Inserir dados

1. Na página Esquema, clique em Dados, no menu à esquerda. Em seguida, clique em Inserir.

2. Isso abre automaticamente a guia Consulta do Spanner Studio. Clique em Limpar consulta, cole a consulta abaixo e então selecione Executar:

INSERT INTO Customer (CustomerId, Name, Location) VALUES ('bdaaaa97-1b4b-4e58-b4ad-84030de92235', 'Richard Nelson', 'Ada Ohio' );

3. O resultado aparece na parte de baixo da tela. A tabela Cliente agora tem uma linha:

4. Adicione uma segunda linha. Substitua a instrução anterior pelas informações abaixo e clique em Executar:

INSERT INTO Customer (CustomerId, Name, Location) VALUES ('b2b4002d-7813-4551-b83b-366ef95f9273', 'Shana Underwood', 'Ely Iowa' );

Executar uma consulta

1. Você pode executar uma instrução SQL na página de consultas do seu banco de dados.

2. No painel à esquerda do Console do Cloud Platform, clique em Spanner Studio para acessar a janela da interface de consultas.

3. Clique no ícone + azul para abrir a página Consulta. Selecione Limpar consulta, cole a consulta abaixo e clique em "Executar":

SELECT * FROM Customer;

4. Clique em Executar.

5. O Console do Cloud vai mostrar o resultado da sua consulta.

Tarefa 5: usar a CLI do Google Cloud com o Cloud Spanner

O Console do Cloud é muito útil, mas haverá casos em que você vai querer gerenciar as instâncias do Spanner usando outros métodos. Os serviços do Google Cloud também podem ser gerenciados pela ferramenta de linha de comando chamada gcloud. A maneira mais fácil de usar a CLI da gcloud é pelo ambiente do Cloud Shell, mas ela também pode ser instalada em uma ampla variedade de sistemas operacionais.

Criar uma instância com a CLI

1. Criar uma instância do Spanner usando a gcloud é muito simples. O comando principal é o seguinte:

gcloud spanner instances create [INSTANCE-ID] \ --config=[INSTANCE-CONFIG] \ --description="[INSTANCE-NAME]" \ --nodes=[NODE-COUNT]

2. No Cloud Shell, crie um novo Cloud Spanner usando o comando abaixo.

gcloud spanner instances create banking-instance-2 \ --config=regional-{{{project_0.default_region}}} \ --description="Banking Instance 2" \ --nodes=2

Como listar instâncias

1. É possível executar o seguinte comando para listar as instâncias do Spanner disponíveis no projeto.

gcloud spanner instances list

Como criar um banco de dados

1. Você também pode criar bancos de dados em uma instância do Spanner usando a gcloud.

2. No Cloud Shell, crie um novo banco de dados usando o comando abaixo.

gcloud spanner databases create banking-db-2 --instance=banking-instance-2

3. Clique em Verificar meu progresso para conferir a conclusão desta etapa.

Criar uma instância e um banco de dados com a CLI

Como modificar o número de nós

Vale lembrar que o provisionamento de nós precisa ser o necessário para manter a utilização e o uso do armazenamento da CPU dentro dos valores máximos recomendados. Mas, às vezes, será necessário reduzir o número de nós.

1. Agora, você vai reduzir o número de nós da instância banking-instance-2 de dois para um.

2. Use o seguinte comando gcloud para ajustar a instância:

gcloud spanner instances update banking-instance-2 --nodes=1

3. Após a conclusão, verifique se o número de nós foi reduzido:

gcloud spanner instances list

Tarefa 6: usar ferramentas de automação com o Cloud Spanner

Com o crescimento das suas arquiteturas do Spanner, tanto em número como em complexidade, vai ser necessário automatizar a implantação e o gerenciamento das instâncias nesse banco de dados. Uma das ferramentas disponíveis para implantar e gerenciar o Spanner é o Terraform.

Este laboratório não inclui instruções sobre o Terraform. Se você ainda não conhece, recomendamos ler a documentação do recurso.

Em resumo, você fornece ao Terraform um conjunto de arquivos que descrevem a infraestrutura ou os serviços a serem implantados no Google Cloud, o que é chamado de configuração. Em seguida, você instrui o Terraform a iniciar e planejar a implantação, antes de aplicar as mudanças.

Verificar a instalação do Terraform

1. O Terraform vem pré-instalado no Cloud Shell. Use o Cloud Shell anterior (ou abra-o novamente, se estiver fechado) para verificar se o Terraform está disponível:

terraform -version

2. O resultado será parecido com este:

Terraform v1.5.6 on linux_amd64 Observação: você pode ignorar qualquer aviso sobre a versão do Terraform estar desatualizada.

Criar a configuração do Terraform

1. No Cloud Shell, insira o comando a seguir para invocar o editor de texto Nano e criar um novo arquivo de configuração vazio chamado spanner.tf.

nano spanner.tf

2. No editor Nano, cole o bloco de código listado abaixo.

resource "google_spanner_instance" "banking-instance-3" { name = "banking-instance-3" config = "regional-{{{project_0.default_region}}}" display_name = "Banking Instance 3" num_nodes = 2 labels = { } }

3. Pressione Ctrl+X para sair do Nano, Y para confirmar a atualização e Enter para salvar as alterações.

Implantação

1. A próxima etapa é verificar se todos os provedores de serviços do Terraform estão disponíveis (nesse caso, o provedor de serviços do Spanner). Para isso, execute o seguinte comando no Cloud Shell:

terraform init

2. Em seguida, instrua o Terraform a criar um plano de execução com base no arquivo de configuração que você criou em uma etapa anterior. Para isso, execute o comando a seguir:

terraform plan

3. A saída vai mostrar os detalhes sobre a nova instância que será criada. Execute o comando a seguir para aplicar o plano ao seu projeto:

terraform apply

4. O plano vai aparecer novamente e o Terraform vai pausar e aguardar a aprovação para continuar. Digite yes para o Terraform criar a nova instância.

5. O comando "apply" vai processar a solicitação e retornar a seguinte saída:

Apply complete! Resources: 1 added, 0 changed, 0 destroyed.

6. Confirme se a nova instância, banking-instance-3, foi criada:

gcloud spanner instances list

Tarefa 7: como excluir instâncias

1. Uma maneira muito rápida de excluir uma instância é usando a CLI. Para isso, execute o comando a seguir:

gcloud spanner instances delete banking-instance-2

2. Para confirmar que banking-instance-2 foi excluída, execute o seguinte comando:

gcloud spanner instances list

Parabéns!

Agora, você já conhece e entende as ações administrativas básicas necessárias para usar uma instância do Cloud Spanner.

Treinamento e certificação do Google Cloud

Esses treinamentos ajudam você a aproveitar as tecnologias do Google Cloud ao máximo. Nossas aulas incluem habilidades técnicas e práticas recomendadas para ajudar você a alcançar rapidamente o nível esperado e continuar sua jornada de aprendizado. Oferecemos treinamentos que vão do nível básico ao avançado, com opções de aulas virtuais, sob demanda e por meio de transmissões ao vivo para que você possa encaixá-las na correria do seu dia a dia. As certificações validam sua experiência e comprovam suas habilidades com as tecnologias do Google Cloud.

Manual atualizado em 24 de fevereiro de 2025.

Laboratório testado em 24 de fevereiro de 2025.

Copyright 2025 Google LLC. Todos os direitos reservados. Google e o logotipo do Google são marcas registradas da Google LLC. Todos os outros nomes de produtos e empresas podem ser marcas registradas das respectivas empresas a que estão associados.