Guia de início rápido sobre o uso do console

Neste guia de início rápido, mostramos como realizar operações básicas no Cloud Spanner usando o Console do Google Cloud. No início rápido, você vai:

• criar uma instância, um banco de dados e uma tabela do Cloud Spanner;
• adicionar um esquema;
• gravar e modificar dados;
• executar uma consulta.

Observação: para informações sobre custos de utilização do Cloud Spanner, consulte Preços.

Antes de começar

1. Faça login na sua conta do Google.

   Se você ainda não tiver uma, inscreva-se.

2. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar a página do seletor de projetos

3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

4. Ative a API Cloud Spanner para o projeto.

   Ativar a API Cloud Spanner

Criar uma instância

Quando você usa o Cloud Spanner pela primeira vez, é preciso criar uma instância que é uma alocação de recursos usados pelos bancos de dados do Cloud Spanner naquela instância.

1. Acesse a página Instâncias do Cloud Spanner no Console do Cloud.

   Acesse a página "Instâncias".

2. Clique em Criar instância.

3. Para o nome da instância, insira Instância de teste.

4. Para o código da instância, insira test-instance.

5. Use uma configuração regional.

6. Escolha qualquer configuração regional no menu suspenso.

   A localização geográfica em que as instâncias são armazenadas e replicadas é determinada pela configuração da instância.

7. Use 1 para a contagem de nó.

   A página de criação de instância ficará assim:

   

8. Clique em Criar.

   Sua instância aparece na lista de instâncias.

Criar um banco de dados

1. Acesse a página Instâncias do Cloud Spanner no Console do Cloud.

   Acesse a página "Instâncias".

2. Clique em Instância de teste.

3. Clique em Criar banco de dados.

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

   A página de criação de banco de dados ficará assim:

   

5. Clique em Continuar.

6. Ignore a etapa Definir o esquema de banco de dados por enquanto. Você definirá o esquema na próxima seção deste início rápido.

7. Clique em Criar.

   O Console do Cloud exibe a página Detalhes do banco de dados após a criação do banco de dados.

Criar um esquema para o banco de dados

O Console do Cloud oferece duas maneiras de criar, alterar e excluir tabelas e índices em um banco de dados:

• Com o editor de banco de dados padrão para especificar cada parte de tabelas, colunas e índices.
• Alternando o editor para Editar como texto e inserindo instruções SQL na sintaxe de Linguagem de definição de dados (DDL, na sigla em inglês) do Cloud Spanner.

Este início rápido usa o DDL.

1. No painel esquerdo do Console do Cloud, clique no banco de dados example-db.
2. Clique em Criar tabela.
3. Clique na alternativa Edit as text.

4. No campo Instrução DDL, digite:

   CREATE TABLE Singers (
     SingerId   INT64 NOT NULL,
     FirstName  STRING(1024),
     LastName   STRING(1024),
     SingerInfo BYTES(MAX),
     BirthDate  DATE,
   ) PRIMARY KEY(SingerId);
   

5. Clique em Criar

   Esse processo pode levar alguns minutos. Quando a operação estiver concluída, o Console do Cloud exibirá os detalhes da tabela que você criou:

   

Inserir e modificar dados

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

Inserir dados

1. No painel esquerdo do Console do Cloud, clique em Singers.
2. Clique em Dados.
3. Clique em Inserir.

4. Digite os seguintes valores:

   Campo	Valor
   SingerID:INT64	1
   BirthDate:DATE	[deixe em branco]
   FirstName:STRING	Marc
   LastName:STRING	Richards
   SingerInfo:BYTES	[deixe em branco]

5. Clique em Salvar.

   A tabela Singers agora tem uma linha:

   

6. Clique em Inserir para adicionar mais uma linha.

7. Digite os seguintes valores:

   Campo	Valor
   SingerID:INT64	2
   BirthDate:DATE	[deixe em branco]
   FirstName:STRING	Catalina
   LastName:STRING	Smith
   SingerInfo:BYTES	[deixe em branco]

8. Clique em Salvar.

   A tabela Singers agora tem duas linhas:

   

Também é possível inserir valores de string vazios quando inserir dados.

1. No painel esquerdo, clique em Singers.
2. Clique em Dados.
3. Clique em Inserir.

4. Digite os seguintes valores:

   Campo	Valor
   SingerID:INT64	3
   BirthDate:DATE	[deixe em branco]
   FirstName:STRING	Kena
   LastName:STRING	[verifique String vazia]
   SingerInfo:BYTES	[deixe em branco]

5. Clique em Salvar.

   A tabela Singers agora tem três linhas, e a linha para SingerID 3 tem um LastName que é uma string vazia:

   

Editar dados

1. No painel esquerdo do Console do Cloud, clique em Singers.
2. Clique em Dados.
3. Marque a caixa ao lado da linha para o SingerId 3 e clique em Editar.

4. Digite o seguinte valor:

   Campo	Valor
   BirthDate:DATE	1961-04-01
   [todos os outros campos]	[deixe como está]

5. Clique em Salvar.

   A linha para SingerId 3 na tabela Singers agora tem um valor BirthDate:

   

Excluir dados

1. No painel esquerdo do Console do Cloud, clique em Singers.
2. Clique em Dados.
3. Marque a caixa ao lado da linha para o SingerId 2 e clique em Excluir.

4. Na caixa de diálogo exibida, clique em OK.

   A tabela Singers agora tem duas linhas:

   

Executar uma consulta

Agora é possível executar uma instrução SQL na página de consulta.

1. No painel esquerdo do Console do Cloud, clique em example-db para navegar até a página Detalhes do banco de dados.
2. Na página Detalhes do banco de dados, clique em Consulta.

3. Para a consulta, digite:

   SELECT * FROM Singers
   

4. Clique em Executar consulta.

   O Console do Cloud exibe o resultado da sua consulta:

   

Parabéns! Você criou com sucesso um banco de dados do Cloud Spanner e executou uma instrução SQL usando o editor de consulta.

Limpeza

Para evitar cobranças adicionais à sua conta do Google Cloud, exclua o banco de dados e a instância que você criou.

Excluir o banco de dados

1. Acesse a página instâncias do Cloud Spanner no Console do Google Cloud.

   Acesse a página "Instâncias".

2. Clique em Instância de teste.

3. Clique em example-db.

4. Na página Detalhes do banco de dados, clique em EXCLUIR BANCO DE DADOS.

5. Confirme se quer excluir o banco de dados e clique em Excluir.

Excluir a instância

A exclusão de uma instância exclui automaticamente todos os bancos de dados criados nessa instância.

1. Acesse a página instâncias do Cloud Spanner no Console do Google Cloud.

   Acesse a página "Instâncias".

2. Clique em Instância de teste.

3. Clique em EXCLUIR INSTÂNCIA.

4. Confirme se quer excluir a instância e clique em Excluir.

A seguir

• Saiba mais sobre Instâncias.
• Compreenda o Esquema e modelo de dados do Cloud Spanner.
• Saiba mais sobre a Linguagem de definição de dados (DDL, na sigla em inglês).
• Saiba mais sobre os planos de execução de consulta.
• Saiba como usar o Cloud Spanner com C ++, C#, Go, Java, Node.js, PHP, Python, Ruby, REST ou gcloud.