Guia de início rápido sobre como usar o console

Este início rápido mostra como executar operações básicas no Cloud Spanner usando o Console do Google Cloud Platform. 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. Selecione ou crie um projeto do Google Cloud Platform.

    Acessar a página Gerenciar recursos

  3. Verifique se o faturamento foi ativado no projeto do Google Cloud Platform.

    Saiba como ativar o faturamento

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 do Spanner no Console do GCP.
    Acessar a página do Spanner
  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 node.
    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.
    A instância aparece na página Instâncias do Spanner.

Criar um banco de dados

  1. Acesse a página Instâncias do Spanner no Console do GCP.
    Acessar a página Instâncias do Spanner
  2. Clique na instância 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.
    No Console do GCP é exibida a página de detalhes do banco de dados após a criação do banco de dados.

Criar um esquema para o banco de dados

Há duas maneiras de criar, alterar e excluir tabelas e índices em um banco de dados no Console do GCP:

  • 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 GCP, 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.
    Isso pode demorar alguns minutos para terminar. Quando a operação estiver concluída, o Console do GCP exibirá os detalhes da tabela que você criou:

    Captura de tela da tabela

Inserir e modificar dados

No Console do GCP é fornecida uma interface para inserir, editar e excluir dados.

Inserir dados

  1. No painel esquerdo do Console do GCP, 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 Singers com uma linha

  6. Clique em Inserir para adicionar uma linha adicional.

  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 Singers com duas linhas

Você também pode 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 Singers com três linhas

Editar dados

  1. No painel esquerdo do Console do GCP, 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 GCP, 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 que aparece, 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 você pode executar uma instrução SQL na página de consulta.

  1. No painel esquerdo do Console do GCP, clique em exemplo-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 Gerar consulta.
    O Console do GCP exibirá o resultado da 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 na sua conta do Google Cloud Platform, 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 Spanner no Console do Google Cloud Platform.
    Acessar a página Instâncias do Spanner
  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 Spanner no Console do Google Cloud Platform.
    Acessar a página Instâncias do Spanner
  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

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud Spanner