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. 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

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

  6. 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. Selecione um dialeto de banco de dados.

    Para informações sobre o suporte ao PostgreSQL e orientações sobre como escolher um dialeto, consulte a Interface PostgreSQL.

  6. Se você selecionou o Google SQL padrão, deixe o campo de texto Definir seu esquema em branco 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 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 Escrever instruções DDL.

  2. Insira:

    SQL padrão do Google

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

    PostgreSQL

    CREATE TABLE Singers (
      SingerId   BIGINT PRIMARY KEY,
      FirstName  VARCHAR(1024),
      LastName   VARCHAR(1024),
      SingerInfo BYTEA,
      BirthDate  TIMESTAMPTZ
    );
    
  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:

    SQL padrão do Google

    Captura de tela da tabela

    PostgreSQL

    Captura de tela da tabela

    O PostgreSQL converte o nome da tabela em letras minúsculas.

Insira e modifique 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 da 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 "Singers" com uma nova guia de consulta contendo instruções INSERT e SELECT de modelos que você edita para inserir uma linha nessa tabela e ver o resultado dessa inserção:

    SQL padrão do Google

      -- 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>;
    

    PostgreSQL

      -- 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: bigint
        <birthdate>, -- type: timestamp with time zone
        <firstname>, -- type: character varying
        <lastname>, -- type: character varying
        <singerinfo> -- type: bytea
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      singers
    WHERE
      singerid=<singerid>;
    

    O PostgreSQL converte os nomes das colunas em minúsculas.

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

    SQL padrão do Google

      -- 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;
    

    PostgreSQL

      -- 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: bigint
        NULL, -- type: timestamp with time zone
        'Marc', -- type: character varying
        'Richards', -- type: character varying
        NULL -- type: bytea
        );
      -- 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 Resultados 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:

    SQL padrão do Google

    Captura de tela dos dados da tabela Singers com uma linha

    PostgreSQL

    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 "Singers" 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:

    SQL padrão do Google

      -- 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;
    

    PostgreSQL

      -- 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: bigint
        NULL, -- type: timestamp with time zone
        'Catalina', -- type: character varying
        'Smith', -- type: character varying
        NULL -- type: bytea
        );
      -- 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 tabela. A tabela Singers agora tem duas linhas:

    SQL padrão do Google

    Captura de tela dos dados da tabela Singers com duas linhas

    PostgreSQL

    Captura de tela dos dados da tabela Singers 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 "Singers" 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:

    SQL padrão do Google

      -- 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;
    

    PostgreSQL

      -- 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: bigint
        NULL, -- type: timestamp with time zone
        'Kena', -- type: character varying
        '', -- type: character varying
        NULL -- type: bytea
        );
      -- Change values in the WHERE condition to match the inserted row.
    SELECT
      *
    FROM
      singers
    WHERE
      singerid=3;
    

    O valor fornecido na coluna de sobrenome é uma string vazia, '', 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 tabela. A tabela singers agora tem três linhas, e a linha com o valor de chave primária de 3 tem uma coluna de sobrenome que é uma string vazia:

    SQL padrão do Google

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

    PostgreSQL

    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 com o valor da chave primária de 3 e clique em Editar.

    O Console do Cloud exibe a página Consulta com uma nova guia contendo as instruções UPDATE e SELECT do modelo que você editar. Observe que as cláusulas WHERE das duas instruções indicam que a linha a ser atualizada é a que tem o valor da chave primária de 3.

    SQL padrão do Google

      -- 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;
    

    PostgreSQL

      -- 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 data de nascimento:

    SQL padrão do Google

      -- 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;
    

    PostgreSQL

      -- Change values in the SET clause to update the row where the WHERE condition is true.
    UPDATE
      singers
    SET
      birthdate='1961-04-01 00:00:00 -8:00'
    WHERE
      singerid='3';
    SELECT
      *
    FROM
      singers
    WHERE
      singerid='3';
    
  3. Clique em Executar.

    O Cloud Spanner executa as instruções. Quando terminar, a guia Resultados 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 atualizada agora tem um valor para a data de nascimento.

    SQL padrão do Google

    Captura de tela dos dados da tabela &quot;Singers&quot; com uma linha atualizada

    PostgreSQL

    Captura de tela dos dados da tabela &quot;Singers&quot; com uma linha atualizada

Excluir dados

  1. Na página Dados da tabela "Singers", marque a caixa ao lado da linha com 2 na primeira coluna e clique em Excluir.
  2. Na caixa de diálogo que aparece, clique em Confirmar.

    A tabela Singers agora tem duas linhas:

    SQL padrão do Google

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

    PostgreSQL

    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:

    SQL padrão do Google

    SELECT * FROM Singers;
    

    PostgreSQL

    SELECT * FROM singers;
    
  3. Clique em Executar.

    O Cloud Spanner executa a consulta. Quando terminar, a guia Resultados exibirá o resultado da consulta:

    SQL padrão do Google

    Captura de tela dos resultados da consulta

    PostgreSQL

    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