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 Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o 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 a capacidade de computação padrão de 1.000 unidades de processamento.

    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.

    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:

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

  5. Pule a etapa Definir seu esquema por enquanto. Você definirá o esquema na próxima seção deste início rápido.

  6. Clique em Criar.

    O Console do Cloud exibe a página Visão geral para o banco de dados que você criou.

Crie um esquema para o banco de dados

  1. Na página Visão geral do example-db, clique em Criar tabela no início da lista de tabelas.

    O Console do Cloud exibe a página Criar instruções DDL.

  2. Digite:

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

  3. Clique em Enviar.

    O Console do Cloud retorna à página Visão geral do example-db e mostra que as atualizações do esquema estão em andamento. Quando a atualização for concluída, a página ficará assim:

    Captura de tela da tabela

Inserir e modificar dados

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

Insira dados

  1. Na página Visão geral do example-db, clique na tabela singers na lista de tabelas.

    O Console do Cloud exibe a página Esquema na tabela "singers".

  2. No menu lateral, clique em Dados para exibir a página Dados da tabela "singers".

  3. Clique em Insert.

    O Console do Cloud exibe a página Consulta da tabela singular com uma nova guia de consulta contendo instruções INSERT e SELECT de modelos editadas para inserir uma linha nessa tabela. ver o resultado dessa inserção:

      -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      Singers (SingerId,
        BirthDate,
        FirstName,
        LastName,
        SingerInfo)
    VALUES
      (<SingerId>, -- type: INT64
        <BirthDate>, -- type: DATE
        <FirstName>, -- type: STRING(1024)
        <LastName>, -- type: STRING(1024)
        <SingerInfo> -- type: BYTES(MAX)
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      Singers
    WHERE
      SingerId=<SingerId>;
    
  4. Edite a cláusula VALUES da instrução INSERT e a cláusula WHERE da instrução SELECT:

      -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      Singers (SingerId,
        BirthDate,
        FirstName,
        LastName,
        SingerInfo)
    VALUES
      (1, -- type: INT64
        NULL, -- type: DATE
        'Marc', -- type: STRING(1024)
        'Richards', -- type: STRING(1024)
        NULL -- type: BYTES(MAX)
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      Singers
    WHERE
      SingerId=1;
    
  5. Clique em Executar.

    O Cloud Spanner executa as instruções. Quando terminar, a guia Results indica que a primeira instrução inseriu uma linha e fornece um link para visualizar os dados da tabela.

  6. Na guia Resultados, clique no link da tabela. A tabela singers agora tem uma linha:

    Captura de tela dos dados da tabela Singers com uma linha

  7. Clique em Insert para adicionar mais uma linha.

    O Console do Cloud exibe novamente a página Consulta da tabela singulares com uma nova guia de consulta que contém as mesmas instruções INSERT e SELECT do modelo.

  8. Edite a cláusula VALUES da instrução INSERT e a cláusula WHERE da instrução SELECT:

      -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      Singers (SingerId,
        BirthDate,
        FirstName,
        LastName,
        SingerInfo)
    VALUES
      (2, -- type: INT64
        NULL, -- type: DATE
        'Catalina', -- type: STRING(1024)
        'Smith', -- type: STRING(1024)
        NULL -- type: BYTES(MAX)
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      Singers
    WHERE
      SingerId=2;
    
  9. Clique em Executar.

    Depois que o Cloud Spanner executa as instruções, a guia Resultados novamente indica que a primeira instrução inseriu uma linha.

  10. Clique no link da tabela. A tabela Singers agora tem duas linhas:

    Captura de tela dos dados da tabela &quot;Singers&quot; com duas linhas

Você também pode inserir valores de string vazios quando inserir dados.

  1. Clique em Inserir para adicionar a linha.

    O Console do Cloud exibe novamente a página Consulta da tabela singulares com uma nova guia de consulta que contém as mesmas instruções INSERT e SELECT do modelo.

  2. Edite a cláusula VALUES da instrução INSERT do modelo e a cláusula WHERE da instrução SELECT:

        -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      Singers (SingerId,
        BirthDate,
        FirstName,
        LastName,
        SingerInfo)
    VALUES
      (3, -- type: INT64
        NULL, -- type: DATE
        'Kena', -- type: STRING(1024)
        '', -- type: STRING(1024)
        NULL -- type: BYTES(MAX)
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      Singers
    WHERE
      SingerId=3;
    

    O valor fornecido para LastName é uma string vazia, '', e não um valor NULL.

  3. Clique em Executar.

    Depois que o Cloud Spanner executa as instruções, a guia Resultados novamente indica que a primeira instrução inseriu uma linha.

  4. Clique no link da tabela. A tabela singers agora tem três linhas, e a linha de SingerID 3 tem um LastName que é uma string vazia:

    Captura de tela dos dados da tabela Singers com três linhas

Edite dados

  1. Na página Dados da tabela "singers", marque a caixa ao lado da linha para SingerId 3 e clique em Editar.

    O Console do Cloud exibe a página Consulta da tabela singulares com uma nova guia de consulta que contém instruções UPDATE e SELECT de modelo editadas para atualizar a linha na tabela "candidatos" e ver o resultado dessa atualização. Observe que as cláusulas WHERE das duas instruções indicam que a linha a ser atualizada é a de SingerId 3.

      -- Change values in the SET clause to update the row where the WHERE condition is true.
    UPDATE
      Singers
    SET
      BirthDate='',
      FirstName='Kena',
      LastName='',
      SingerInfo=''
    WHERE
      SingerId=3;
    SELECT
      *
    FROM
      Singers
    WHERE
      SingerId=3;
    
  2. Edite a cláusula SET da instrução UPDATE para atualizar somente a coluna BirthDate:

      -- Change values in the SET clause to update the row where the WHERE condition is true.
    UPDATE
      Singers
    SET
      BirthDate='1961-04-01'
    WHERE
      SingerId=3;
    SELECT
      *
    FROM
      Singers
    WHERE
      SingerId=3;
    
  3. Clique em Executar.

    O Cloud Spanner executa as instruções. Quando terminar, a guia Results indica que a primeira instrução atualizou uma linha e fornece um link para visualizar os dados da tabela.

  4. Na guia Resultados, clique no link da tabela. A linha de SingerId 3 na tabela políticas 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. Na página Dados da tabela "singers", marque a caixa ao lado da linha para SingerId 2 e clique em Excluir.
  2. Na caixa de diálogo exibida, clique em Confirmar.

    A tabela Singers agora tem duas linhas:

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

Execute uma consulta

  1. Na página Visão geral do example-db, clique em Consulta no menu lateral para exibir a página Consulta do example-db.

  2. Clique em Nova guia para criar uma nova guia de consulta. Em seguida, insira esta consulta:

    SELECT * FROM Singers;
    
  3. Clique em Executar.

    O Cloud Spanner executa a consulta. Quando esse processo for concluído, a guia Resultados 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 conta de faturamento do 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