Criar e se conectar a um banco de dados

Nesta página, você vai aprender a criar e se conectar ao seu primeiro banco de dados no AlloyDB para PostgreSQL.

As instruções fornecidas no final deste guia de início rápido mostram como 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. Verify 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. Verify 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 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

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

  2. Verifique se o faturamento está ativado para seu 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 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

  5. 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 as APIs Compute Engine e Service Networking estão ativadas nesse projeto para que seja possível configurar a VPC compartilhada e o acesso a serviços particulares.

    gcloud services list

Criar um cluster e a instância principal dele

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

    Acessar Clusters

  2. Clique em Criar cluster.

  3. Em Configurar o cluster, siga estas etapas:

    1. No campo ID do cluster, insira my-cluster.

    2. Digite uma senha. Anote essa senha porque ela será usada neste guia de início rápido.

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

    4. No menu suspenso Região de Local, selecione a região us-central1 (Iowa).

  4. Em Configurar sua instância principal, siga estas etapas:

    1. No campo ID da instância, insira my-cluster-primary.

    2. Em Disponibilidade por zona, clique em Zona única.

    3. No menu suspenso Tipo de máquina, selecione o tipo 2 vCPU, 16 GB.

    4. No menu suspenso Rede de Conectividade, selecione a rede default.

      Se você tiver uma conexão de acesso particular, continue para a etapa de criação de um cluster. Caso contrário, clique em Configurar conexão e siga estas etapas:

      1. Em Alocar um intervalo de IP, clique em Usar intervalo de IPs atribuído automaticamente.

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

    5. Mantenha as configurações padrão em Segurança de rede.

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

  1. No Google Cloud console, 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. Escolha um método de autenticação de banco de dados.

    2. Selecione o banco de dados postgres.

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

  1. No Google Cloud console, 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. Insira a senha que você criou 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 Resultados 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 Resultados:

        guestname     | content     | entryid
    --------------+-------------+---------
    Alex          | I got here! | 1
    Kai           | Me too!     | 2

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

  1. No Google Cloud console, 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 Excluir cluster my-cluster, insira 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 a página Redes do Google Cloud console e clique em Excluir rede VPC.

A seguir