Criar e consultar um banco de dados no console do Google Cloud

Neste guia de início rápido, mostramos como usar o console do Google Cloud para criar um banco de dados no Spanner, inserir dados e executar uma consulta SQL.

No início rápido, você vai:

  • Criar uma instância do Spanner.
  • Cria um banco de dados.
  • Criar um esquema.
  • Inserir e modificar dados
  • executar uma consulta.

Para mais informações sobre o custo do uso do Spanner, consulte Preços.

Antes de começar

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Opcional: a API Cloud Spanner é ativada automaticamente quando você cria uma instância do Spanner. Se não estiver, ative-o manualmente:

    Ativar a API Cloud Spanner
  4. Para receber as permissões necessárias para criar instâncias e bancos de dados, peça ao administrador para conceder a você o papel do IAM de Administrador do Cloud Spanner (roles/spanner.admin) no projeto.

Criar uma instância com o console do Google Cloud

Quando você usa o Spanner pela primeira vez, é preciso criar uma instância, que é uma alocação de recursos usados pelos bancos de dados do Spanner naquela instância.

  1. No console Google Cloud , acesse a página Spanner.

    Acessar o Spanner

  2. Na página do Spanner, clique em Criar uma instância provisionada.

    Se você já usou o Spanner, vai ver a página Instâncias do Spanner em vez da página do produto. Clique em Criar instância.

  3. Na seção Selecionar uma edição, escolha Standard e clique em Continuar.

  4. Na seção Nomear sua instância, insira um Nome da instância, como Test Instance.

    O Spanner preenche o ID da instância com base no nome da instância, por exemplo, test-instance. Altere o ID da instância, se necessário, e clique em Continuar.

  5. Na seção Configurar sua instância, em Escolher uma configuração, mantenha a opção padrão Regional e selecione um local de configuração no menu suspenso.

    A configuração da instância determina a localização geográfica em que o Spanner armazena e replica suas instâncias.

  6. Clique em Continuar.

  7. Na seção Configurar capacidade de computação, em Selecionar unidade, escolha Unidades de processamento (PUs). Em Escolher um modo de escalonamento, mantenha Alocação manual e a Quantidade padrão de unidades de processamento 1000.

  8. Opcional: na seção Backups, desmarque a caixa de seleção Ativar programações de backup padrão se não quiser que as programações de backup padrão sejam criadas para essa instância de teste.

  9. Clique em Criar.

    O console do Google Cloud exibe a página Visão geral da instância que você criou.

Criar um banco de dados

  1. No console do Google Cloud , acesse a página Instâncias do Spanner.

    Acessar as instâncias do Spanner

  2. Clique na instância que você criou, por exemplo, Instância de teste.

  3. Na página Visão geral da instância que é aberta, clique em Criar banco de dados.

  4. Em nome do banco de dados, insira um nome, como example-db.

  5. Selecione um dialeto de banco de dados.

    Para informações sobre o suporte ao PostgreSQL e orientações para escolher um dialeto, consulte Interface PostgreSQL. Deixe a seção Definir seu esquema (opcional) em branco. Você define o esquema no Spanner Studio na próxima seção deste guia de início rápido.

  6. Clique em Criar.

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

Crie um esquema para o banco de dados

  1. No menu de navegação, clique em Spanner Studio.

  2. Na página Spanner Studio, clique em Nova guia ou use a guia Consulta sem título e insira uma das seguintes consultas, dependendo do dialeto do banco de dados:

    GoogleSQL

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

    PostgreSQL

    CREATE TABLE Singers (
      SingerId   BIGINT PRIMARY KEY,
      FirstName  VARCHAR(1024),
      LastName   VARCHAR(1024),
      BirthDate  TIMESTAMPTZ
    );
    
  3. Clique em Executar.

    O Spanner executa a instrução. Quando terminar, a guia Resultados vai mostrar Atualização concluída.

Insira e modifique dados

O console do Google Cloud conta com uma interface para inserir, editar e excluir dados.

Inserir dados

  1. No painel Explorer, clique em Ver ações para a tabela Singers e, em seguida, clique em Inserir dados.

    O Spanner abre uma nova guia de consulta no Spanner Studio que contém um modelo de instrução INSERT.

  2. Edite a cláusula VALUES da instrução INSERT do modelo para inserir uma linha na tabela Singers e conferir o resultado dessa inserção:

    GoogleSQL

      -- 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,
        FirstName,
        LastName,
        BirthDate)
    VALUES
      (1, -- type: INT64
        'Marc', -- type: STRING(1024)
        'Richards', -- type: STRING(1024)
        NULL -- type: DATE
        )
    THEN RETURN
      SingerId,
      FirstName,
      LastName,
      BirthDate;
    

    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,
        firstname,
        lastname,
        birthdate)
    VALUES
      (1, -- type: bigint
        'Marc', -- type: character varying
        'Richards', -- type: character varying
        NULL -- type: timestamp with time zone
        )
    RETURNING
      singerid,
      firstname,
      lastname,
      birthdate;
    

    Observe que o PostgreSQL converte os nomes das colunas em letras minúsculas.

  3. Clique em Executar.

    O Spanner executa a instrução. Quando terminar, a guia Resultados vai mostrar 1 linha inserida e os dados dela.

  4. No painel Explorer, clique em Ver ações para a tabela Singers e, em seguida, clique em Inserir dados.

  5. Edite a cláusula VALUES da instrução INSERT:

    GoogleSQL

      -- 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,
        FirstName,
        LastName,
        BirthDate)
    VALUES
      (2, -- type: INT64
        'Catalina', -- type: STRING(1024)
        'Smith', -- type: STRING(1024)
        NULL -- type: DATE
        )
    THEN RETURN
      SingerId,
      FirstName,
      LastName,
      BirthDate;
    

    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,
        firstname,
        lastname,
        birthdate)
    VALUES
      (2, -- type: bigint
        'Catalina', -- type: character varying
        'Smith', -- type: character varying
        NULL -- type: timestamp with time zone
        )
    RETURNING
      singerid,
      firstname,
      lastname,
      birthdate;
    
  6. Clique em Executar.

    O Spanner executa a instrução. Quando a execução for concluída, a guia Resultados vai mostrar 1 linha inserida e os dados da linha inserida.

  7. No painel Explorer, clique em Ver ações para a tabela Singers e, em seguida, clique em Visualizar dados.

  8. Clique em Executar.

    A guia Resultados mostra as duas linhas na tabela Singers.

Também é possível inserir strings vazias em colunas de string.

  1. No painel Explorer, clique em Ver ações para a tabela Singers e, em seguida, clique em Inserir dados.

    O Spanner abre uma nova guia de consulta no Spanner Studio que contém a instrução INSERT do modelo.

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

    GoogleSQL

      -- 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,
        FirstName,
        LastName,
        BirthDate)
    VALUES
      (3, -- type: INT64
        'Kena', -- type: STRING(1024)
        '', -- type: STRING(1024)
        NULL -- type: DATE
        )
    THEN RETURN
      SingerId,
      FirstName,
      LastName,
      BirthDate;
    

    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,
        firstname,
        lastname,
        birthdate)
    VALUES
      (3, -- type: bigint
        'Kena', -- type: character varying
        '', -- type: character varying
        NULL -- type: timestamp with time zone
        )
    RETURNING
      singerid,
      firstname,
      lastname,
      birthdate;
    
  3. Clique em Executar.

    O Spanner executa a instrução. Quando a execução for concluída, a guia Resultados vai mostrar 1 linha inserida e os dados da linha inserida.

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

  4. No painel Explorer, clique em Ver ações para a tabela Singers e, em seguida, clique em Visualizar dados.

  5. Clique em Executar.

    A guia Resultados mostra as três linhas na tabela Singers. A linha com o valor de chave primária de 3 contém uma string vazia na coluna LastName.

Editar dados

  1. Para atualizar a data de nascimento da linha com o valor de chave primária de 3, clique em Nova guia e insira a seguinte instrução UPDATE:

    GoogleSQL

    UPDATE
      Singers
    SET
      BirthDate='1961-04-01'
    WHERE
      SingerId=3
    THEN RETURN
      SingerId,
      FirstName,
      LastName,
      BirthDate;
    

    PostgreSQL

    UPDATE
      singers
    SET
      birthdate='1961-04-01 00:00:00 -8:00'
    WHERE
      singerid=3
    RETURNING
      singerid,
      firstname,
      lastname,
      birthdate;
    
  2. Clique em Executar.

    O Spanner executa a instrução. Quando a execução for concluída, a guia Resultados vai mostrar 1 linha atualizada e os dados da linha atualizada.

  3. No painel Explorer, clique em Ver ações para a tabela Singers e, em seguida, clique em Visualizar dados.

  4. Clique em Executar.

    A guia Resultados mostra as linhas na tabela Singers, com a data de nascimento atualizada do cantor 3.

Excluir dados

  1. Para excluir a linha com o valor de chave primária de 2, clique em Nova guia e insira a seguinte instrução DELETE:

    GoogleSQL

    DELETE FROM Singers
    WHERE SingerId = 2;
    

    PostgreSQL

    DELETE FROM singers
    WHERE singerid = 2;
    
  2. Clique em Executar.

    O Spanner executa a instrução. Quando a execução for concluída, a guia Resultados vai mostrar 1 linha excluída. A tabela Singers contém duas linhas.

Executar uma consulta no console do Google Cloud

  1. Clique em Nova guia para abrir uma nova guia de consulta e insira a seguinte consulta no editor de consultas:

    GoogleSQL

    SELECT * FROM Singers;
    

    PostgreSQL

    SELECT * FROM singers;
    
  2. Clique em Executar.

    O Spanner executa a consulta. Quando terminar, a guia Resultados vai mostrar o resultado da consulta.

Parabéns! Você criou um novo banco de dados, definiu um esquema, inseriu dados e executou uma consulta no editor de consultas do Spanner.

Limpar

Para evitar cobranças extras na sua conta do Google Cloud, exclua o banco de dados e a instância. Desativar a API Cloud Billing não interrompe as cobranças. Quando você exclui uma instância, o Spanner exclui todos os bancos de dados dela.

Excluir o banco de dados

  1. No console do Google Cloud , acesse a página Instâncias do Spanner.

    Acessar as instâncias do Spanner

  2. Clique no nome da instância que tem o banco de dados que você quer excluir, por exemplo, Instância de teste.

  3. Clique no nome do banco de dados que você quer excluir, por exemplo, example-db.

  4. Na página Visão geral do banco de dados, clique em Excluir banco de dados.

  5. Confirme que você quer excluir o banco de dados inserindo o nome dele e clicando em Excluir.

Excluir a instância

  1. No console do Google Cloud , acesse a página Instâncias do Spanner.

    Acessar as instâncias do Spanner

  2. Clique no nome da instância que você quer excluir, por exemplo, Instância de teste.

  3. Clique em Excluir instância.

  4. Confirme que você quer excluir a instância inserindo o nome dela e clicando em Excluir.

A seguir