Criar e se conectar a um banco de dados
Esta página orienta você no processo de criação e conexão com seu primeiro banco de dados no AlloyDB para PostgreSQL.
As instruções fornecidas no final deste guia de início rápido orientam você na limpeza desse novo banco de dados. A página termina com as próximas etapas para saber mais sobre como usar o AlloyDB com seus próprios aplicativos.
Antes de começar
Console
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verify that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verify that billing is enabled for your Google Cloud project.
-
Ative as APIs do Cloud necessárias para criar e se conectar ao AlloyDB para PostgreSQL.
Na etapa Confirmar projeto, clique em Próxima para confirmar o nome do projeto que você vai mudar.
Na etapa Ativar APIs, clique em Ativar para ativar o seguinte:
- API AlloyDB
- API Compute Engine
- API Cloud Resource Manager
- API Service Networking
A API Service Networking é necessária se você planeja configurar a conectividade de rede com o AlloyDB usando uma rede VPC que reside no mesmo projeto Google Cloud do AlloyDB.
As APIs Compute Engine e Cloud Resource Manager são necessárias se você planeja configurar a conectividade de rede com o AlloyDB usando uma rede VPC que reside em um projeto Google Cloud diferente.
gcloud
Crie um Google Cloud projeto ou use um projeto atual:
gcloud projects create PROJECT_ID --set-as-default # For an existing project gcloud config set project PROJECT_ID
Substitua:
PROJECT_ID
: o identificador permanente do projeto.
Verifique se o faturamento foi ativado para o projeto Google Cloud . Saiba como confirmar se o faturamento está ativado para o projeto.
Ative as APIs AlloyDB, Compute Engine e Resource Manager:
gcloud services enable alloydb.googleapis.com gcloud services enable compute.googleapis.com gcloud services enable cloudresourcemanager.googleapis.com
Se você planeja configurar a conectividade de rede com o AlloyDB usando uma rede VPC que reside no mesmo projeto Google Cloud do AlloyDB, ative a API Service Networking no projeto.
gcloud services enable servicenetworking.googleapis.com
Se você planeja configurar a conectividade de rede com o AlloyDB usando uma rede VPC que reside em um projeto Google Cloud diferente, confirme se a API Compute Engine e Service Networking desse projeto estão ativadas para que seja possível configurar a VPC compartilhada e o acesso a serviços particulares nele.
gcloud services list
Criar um cluster e a instância principal dele
OBSERVAÇÃO : se você planeja usar uma rede particular, é possível implantar tanto a configuração de rede particular de sua escolha quanto a instância do AlloyDB com clientes como VMs do Compute Engine usando o Terraform. Para mais informações, consulte Soluções simplificadas de configuração de rede do Cloud.
No console Google Cloud , acesse a página Clusters.
Clique em Criar cluster.
Em ID do cluster, insira
my-cluster
.Insira uma senha. Anote essa senha porque você a usará neste guia de início rápido.
Mantenha a versão padrão do banco de dados.
Em Local, selecione a região
us-central1 (Iowa)
.Em Conectividade, no menu suspenso Rede, selecione a rede
default
.Se você tiver uma conexão de acesso privado, siga para a próxima etapa. Caso contrário, clique em Configurar conexão e siga estas etapas:
Em Alocar um intervalo de IP, clique em Usar um intervalo de IP alocado automaticamente.
Clique em Continuar e em Criar conexão.
Mantenha o ID da instância padrão,
my-cluster-primary
.Em Disponibilidade por zona, mantenha Zona única como a opção selecionada. Embora não recomendemos uma instância de zona única para produção, você vai usar uma única zona neste guia de início rápido para minimizar os custos. Para mais informações, consulte Reduzir custos usando instâncias básicas.
Selecione o tipo de máquina
2 vCPU, 16 GB
.Mantenha as configurações padrão em Conectividade e Segurança de rede.
Não faça mudanças em Mostrar opções avançadas.
Clique em Criar cluster. O AlloyDB pode levar vários minutos para criar o cluster e mostrá-lo na página Visão geral do cluster principal.
Conectar-se à instância e criar um banco de dados
No console Google Cloud , acesse a página Clusters.
Clique no nome do cluster,
my-cluster
, na coluna Nome do recurso.No painel de navegação, clique em AlloyDB Studio.
Na página Fazer login no AlloyDB Studio, siga estas etapas:
Escolha um método de autenticação de banco de dados.
Selecione o banco de dados
postgres
.Clique em Autenticar. O painel Explorer mostra uma lista dos objetos no banco de dados
postgres
.
Para criar um banco de dados, insira a seguinte instrução na guia Editor 1 e clique em Executar:
CREATE DATABASE guestbook;
Você vai saber que o banco de dados foi criado quando a mensagem
Statement executed successfully
aparecer no painel Resultados.
Conecte-se ao banco de dados guestbook
No console Google Cloud , acesse a página Clusters.
Clique no nome do cluster,
my-cluster
, na coluna Nome do recurso.No painel de navegação, clique em AlloyDB Studio.
Na página Fazer login no AlloyDB Studio, siga estas etapas:
Selecione o banco de dados
guestbook
.Selecione o usuário
postgres
.Insira a senha que você criou em Criar um cluster e a instância principal.
Clique em Autenticar. O painel Explorer mostra uma lista dos objetos no banco de dados
guestbook
.
Verificar a conexão do banco de dados
Siga as etapas em Conectar-se ao banco de dados
guestbook
.Para inserir dados de amostra no banco de dados
guestbook
, insira o seguinte na guia Editor 1:CREATE TABLE entries (guestName VARCHAR(255), content VARCHAR(255), entryID SERIAL PRIMARY KEY); INSERT INTO entries (guestName, content) values ('Alex', 'I got here!'); INSERT INTO entries (guestName, content) values ('Kai', 'Me too!');
Clique em Executar. A mensagem
Statement executed successfully
no painel Resultados indica que os dados foram inseridos no banco de dados.Para remover o texto da guia Editor 1 e executar outro comando, clique em Limpar.
Para selecionar todas as entradas no banco de dados, insira a seguinte consulta na guia Editor 1:
SELECT * FROM entries;
Clique em Executar. Uma saída semelhante à seguinte aparece no painel Resultados:
guestname | content | entryid --------------+-------------+--------- Alex | I got here! | 1 Kai | Me too! | 2
Limpar
Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.
No console Google Cloud , acesse a página Clusters.
Clique no nome do cluster,
my-cluster
, na coluna Nome do recurso.Clique em delete Excluir cluster.
Em Excluir cluster my-cluster, digite
my-cluster
para confirmar que você quer excluir o cluster.Clique em Excluir.
Se você criou uma conexão particular ao criar um cluster, acesse a página "Rede" do console Google Cloud e clique em Excluir rede VPC.