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 ajudam você a limpar esse 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

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

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

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

    Go to project selector

  5. Make sure that billing is enabled for your Google Cloud project.

  6. Ative as APIs do Cloud necessárias para criar e se conectar ao AlloyDB para PostgreSQL.

    Ativar as APIs

    1. Na etapa Confirmar projeto, clique em Próxima para confirmar o nome do projeto em que você vai fazer mudanças.

    2. 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 ao AlloyDB usando uma rede VPC que reside no mesmo projeto do Google Cloud que o AlloyDB.

      As APIs Compute Engine e Cloud Resource Manager são necessárias se você planeja configurar a conectividade de rede para o AlloyDB usando uma rede VPC que reside em um projeto diferente do Google Cloud .

gcloud

  1. Crie um projeto ou use um projeto existente:

    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.

  2. Verifique se o faturamento está ativado para o projeto do Google Cloud . Saiba como confirmar se o faturamento está ativado para o projeto.

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

  4. Se você planeja configurar a conectividade de rede para o AlloyDB usando uma rede VPC que reside no mesmo projeto do Google Cloud como o AlloyDB, ative a API Service Networking no projeto.

    gcloud services enable servicenetworking.googleapis.com

  5. Se você planeja configurar a conectividade de rede para o AlloyDB usando uma rede VPC que reside em um projeto do Google Cloud diferente, confirme se a API Compute Engine e a Service Networking nesse projeto estão ativadas para que você possa configurar o acesso a VPC compartilhada e serviços particulares nesse projeto.

    gcloud services list

Criar um cluster e a instância principal

OBSERVAÇÃO : se você planeja usar uma rede particular, é possível implantar a configuração de rede particular que preferir e 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 de nuvem.

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

    Acessar Clusters

  2. Clique em Criar cluster.

  3. Em ID do cluster, insira my-cluster.

  4. Insira uma senha. Anote essa senha porque você vai usá-la neste guia.

  5. Mantenha a versão padrão do banco de dados.

  6. Selecione a região us-central1 (Iowa).

  7. Selecione a rede padrão.

    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:

    1. Em Alocar um intervalo de IP, clique em Usar um intervalo de IP alocado automaticamente.

    2. Clique em Continuar e em Criar conexão.

  8. Mantenha o ID da instância padrão, my-cluster-primary.

  9. Em Disponibilidade por zona, mantenha Zona única como a opção selecionada. Não recomendamos uma única instância de zona para produção, mas 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.

  10. Selecione o tipo de máquina 2 vCPU, 16 GB.

  11. Mantenha as configurações padrão em Conectividade e Segurança de rede.

  12. Não faça mudanças em Mostrar opções avançadas.

  13. Clique em Criar cluster. Pode levar vários minutos para que o AlloyDB crie o cluster e o mostre na página Overview do cluster principal.

Conectar-se à instância e criar um banco de dados

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

    Acessar Clusters

  2. Clique no nome do cluster, my-cluster, na coluna Nome do recurso.

  3. No painel de navegação, clique em AlloyDB Studio.

  4. Na página Fazer login no AlloyDB Studio, siga estas etapas:

    1. Selecione o banco de dados postgres.

    2. Selecione o usuário postgres.

    3. Digite a senha criada em Criar um cluster e a instância principal.

    4. Clique em Autenticar. O painel Explorer mostra uma lista dos objetos no banco de dados postgres.

  5. Para criar um banco de dados, insira a seguinte instrução na guia Editor 1 e clique em Executar:

    CREATE DATABASE guestbook;

    Você saberá que o banco de dados foi criado quando a mensagem Statement executed successfully for exibida no painel Resultados.

Conectar-se ao banco de dados guestbook

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

    Acessar Clusters

  2. Clique no nome do cluster, my-cluster, na coluna Nome do recurso.

  3. No painel de navegação, clique em AlloyDB Studio.

  4. Na página Fazer login no AlloyDB Studio, siga estas etapas:

    1. Selecione o banco de dados guestbook.

    2. Selecione o usuário postgres.

    3. Digite a senha criada em Criar um cluster e a instância principal.

    4. Clique em Autenticar. O painel Explorer mostra uma lista dos objetos no banco de dados guestbook.

Verificar a conexão do banco de dados

  1. Siga as etapas em Conectar-se ao banco de dados guestbook.

  2. 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!');

  3. Clique em Executar. A mensagem Statement executed successfully no painel Results indica que os dados foram inseridos no banco de dados.

  4. Para remover o texto da guia Editor 1 e executar outro comando, clique em Limpar.

  5. Para selecionar todas as entradas no banco de dados, insira a seguinte consulta na guia Editor 1:

    SELECT * FROM entries;

  6. Clique em Executar. Uma saída semelhante à seguinte aparece no painel Results:

        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.

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

    Acessar Clusters

  2. Clique no nome do cluster, my-cluster, na coluna Nome do recurso.

  3. Clique em Excluir cluster.

  4. Em Delete cluster my-cluster, digite my-cluster para confirmar que você quer excluir o cluster.

  5. Clique em Excluir.

  6. Se você criou uma conexão particular ao criar um cluster, acesse o console do Google Cloud na página "Networking" e clique em Delete VPC network.

A seguir