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.

Observação: para conhecer o Spanner usando uma instância de teste sem custo financeiro de 90 dias, consulte Criar uma instância de teste sem custo financeiro do Spanner.

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.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

3. Opcional: a API Spanner deve ser ativada automaticamente. Caso contrário, ative-a manualmente:
   Ativar a API 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. Selecione ou crie um projeto do Google Cloud , caso ainda não tenha feito isso.

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

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

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

   O ID da instância é preenchido automaticamente com base no nome da instância, por exemplo, test-instance. Mude-o, se necessário, e clique em Continuar.

6. 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 localização geográfica em que as instâncias são armazenadas e replicadas é determinada pela configuração da instância.

7. Clique em Continuar.

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

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

10. 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 será aberta, clique em Criar banco de dados.

4. Para o nome do banco de dados, digite 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 seu 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 terminar, a guia Resultados vai mostrar 1 linha inserida e os dados dela.

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 valores de string vazios quando adicionar 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 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 terminar, a guia Resultados vai mostrar 1 linha inserida e os dados dela.

   O valor fornecido para a coluna de sobrenome é 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, e a linha com o valor de chave primária de 3 tem uma string vazia na coluna LastName.

Editar dados

1. Clique em Nova guia para criar uma nova guia de consulta e insira a seguinte instrução UPDATE para atualizar a data de nascimento da linha com o valor de chave primária de 3:

   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 terminar, 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, em que a linha atualizada agora tem um valor para a data de nascimento.

Excluir dados

1. Clique em Nova guia para criar uma nova guia de consulta e insira a seguinte instrução DELETE para excluir a linha com o valor de chave primária de 2:

   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 terminar, a guia Resultados vai mostrar 1 linha excluída. A tabela Singers agora tem duas linhas.

Executar uma consulta no console do Google Cloud

1. Clique em Nova guia para criar uma nova guia de consulta. Em seguida, 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 banco de dados do Spanner e executou uma instrução SQL usando o editor de consultas.

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, todos os bancos de dados nela são excluídos.

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

• Saiba mais sobre Instâncias.
• Entenda o esquema e o modelo de dados do Spanner.
• Saiba mais sobre a linguagem de definição de dados (DDL) do GoogleSQL.
• Saiba mais sobre os planos de execução de consulta.
• Saiba como usar o Spanner com C++, C#, Go, Java, Node.js, PHP, Python, Ruby, REST ou gcloud.