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.

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 Cloud, na página de seletor de projetos, selecione ou crie um projeto do Cloud.

    Acessar a página do seletor de projetos

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud. Saiba como confirmar se a cobrança está ativada para o seu 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.

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

    Acessar 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:

    Captura de tela da janela de criação de instância

  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.

    Acessar 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:

    Captura de tela da janela de criação do banco de dados

  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:

    Captura de tela da tabela

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:

    Captura de tela dos dados da tabela

  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:

    Captura de tela dos dados da tabela

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:

    Captura de tela dos dados da tabela

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:

    Captura de tela dos dados da tabela Singers com três linhas, contendo na terceira linha 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:

    Captura de tela dos dados da tabela Singers com duas linhas. A linha para SingerId 2 desapareceu

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:

    Captura de tela dos resultados da 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.

    Acessar 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 Captura de tela do elemento de exclusão de IU.

  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.

    Acessar a página "Instâncias"

  2. Clique em Instância de teste.

  3. Clique em Excluir Captura de tela do elemento de exclusão de IU.

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

A seguir