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.
Antes de começar
-
Faça login na sua conta do Google.
Se você ainda não tiver uma, inscreva-se.
-
No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
-
Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.
-
Ative a API Cloud Spanner para o projeto.
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.
Acesse a página Instâncias do Cloud Spanner no Console do Cloud.
Clique em Criar instância.
Para o nome da instância, insira Instância de teste.
Para o código da instância, insira test-instance.
Use uma configuração regional.
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.
Use 1 para a contagem de nó.
A página de criação de instância ficará assim:
Clique em Criar.
Sua instância aparece na lista de instâncias.
Criar um banco de dados
Acesse a página Instâncias do Cloud Spanner no Console do Cloud.
Clique em Instância de teste.
Clique em Criar banco de dados.
Para o nome do banco de dados, digite example-db.
A página de criação de banco de dados ficará assim:
Clique em Continuar.
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.
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.
- No painel esquerdo do Console do Cloud, clique no banco de dados example-db.
- Clique em Criar tabela.
- Clique na alternativa Edit as text.
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);
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
- No painel esquerdo do Console do Cloud, clique em Singers.
- Clique em Dados.
- Clique em Inserir.
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] Clique em Salvar.
A tabela Singers agora tem uma linha:
Clique em Inserir para adicionar mais uma linha.
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] Clique em Salvar.
A tabela Singers agora tem duas linhas:
Também é possível inserir valores de string vazios quando inserir dados.
- No painel esquerdo, clique em Singers.
- Clique em Dados.
- Clique em Inserir.
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] 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
- No painel esquerdo do Console do Cloud, clique em Singers.
- Clique em Dados.
- Marque a caixa ao lado da linha para o SingerId
3
e clique em Editar. Digite o seguinte valor:
Campo Valor BirthDate:DATE 1961-04-01
[todos os outros campos] [deixe como está] Clique em Salvar.
A linha para SingerId
3
na tabela Singers agora tem um valor BirthDate:
Excluir dados
- No painel esquerdo do Console do Cloud, clique em Singers.
- Clique em Dados.
- Marque a caixa ao lado da linha para o SingerId
2
e clique em Excluir. 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.
- No painel esquerdo do Console do Cloud, clique em example-db para navegar até a página Detalhes do banco de dados.
- Na página Detalhes do banco de dados, clique em Consulta.
Para a consulta, digite:
SELECT * FROM Singers
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
Acesse a página instâncias do Cloud Spanner no Console do Google Cloud.
Clique em Instância de teste.
Clique em example-db.
Na página Detalhes do banco de dados, clique em delete EXCLUIR BANCO DE DADOS.
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.
Acesse a página instâncias do Cloud Spanner no Console do Google Cloud.
Clique em Instância de teste.
Clique em delete EXCLUIR INSTÂNCIA.
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.