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
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
- 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
-
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.
No console Google Cloud , acesse a página Spanner.
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.
Na seção Selecionar uma edição, escolha Standard e clique em Continuar.
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.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.
Clique em Continuar.
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.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.
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
No console do Google Cloud , acesse a página Instâncias do Spanner.
Clique na instância que você criou, por exemplo, Instância de teste.
Na página Visão geral da instância que é aberta, clique em Criar banco de dados.
Em nome do banco de dados, insira um nome, como
example-db.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.
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
No menu de navegação, clique em Spanner Studio.
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 );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
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.Edite a cláusula
VALUESda instruçãoINSERTdo modelo para inserir uma linha na tabelaSingerse 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.
Clique em Executar.
O Spanner executa a instrução. Quando terminar, a guia Resultados vai mostrar 1 linha inserida e os dados dela.
No painel Explorer, clique em Ver ações para a tabela Singers e, em seguida, clique em Inserir dados.
Edite a cláusula
VALUESda instruçãoINSERT: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;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.
No painel Explorer, clique em Ver ações para a tabela Singers e, em seguida, clique em Visualizar dados.
Clique em Executar.
A guia Resultados mostra as duas linhas na tabela
Singers.
Também é possível inserir strings vazias em colunas de string.
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
INSERTdo modelo.Edite a cláusula
VALUESda instruçãoINSERTdo 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;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 valorNULL.No painel Explorer, clique em Ver ações para a tabela Singers e, em seguida, clique em Visualizar dados.
Clique em Executar.
A guia Resultados mostra as três linhas na tabela
Singers. A linha com o valor de chave primária de3contém uma string vazia na colunaLastName.
Editar dados
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çãoUPDATE: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;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.
No painel Explorer, clique em Ver ações para a tabela Singers e, em seguida, clique em Visualizar dados.
Clique em Executar.
A guia Resultados mostra as linhas na tabela
Singers, com a data de nascimento atualizada do cantor3.
Excluir dados
Para excluir a linha com o valor de chave primária de
2, clique em Nova guia e insira a seguinte instruçãoDELETE:GoogleSQL
DELETE FROM Singers WHERE SingerId = 2;PostgreSQL
DELETE FROM singers WHERE singerid = 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
Singerscontém duas linhas.
Executar uma consulta no console do Google Cloud
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;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
No console do Google Cloud , acesse a página Instâncias do Spanner.
Clique no nome da instância que tem o banco de dados que você quer excluir, por exemplo, Instância de teste.
Clique no nome do banco de dados que você quer excluir, por exemplo, example-db.
Na página Visão geral do banco de dados, clique em Excluir banco de dados.
Confirme que você quer excluir o banco de dados inserindo o nome dele e clicando em Excluir.
Excluir a instância
No console do Google Cloud , acesse a página Instâncias do Spanner.
Clique no nome da instância que você quer excluir, por exemplo, Instância de teste.
Clique em Excluir instância.
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 consultas.
- Saiba como usar o Spanner com C++, C#, Go, Java, Node.js, PHP, Python, Ruby, REST ou a Google Cloud CLI.