Criar e consultar um banco de dados do AlloyDB usando o console do Google Cloud

Criar e consultar um banco de dados do AlloyDB usando o console do Google Cloud

No AlloyDB para PostgreSQL, os bancos de dados são armazenados em clusters que contêm instâncias. Neste guia de início rápido, você vai configurar um cluster, se conectar à instância dele e inserir e consultar dados de amostra. Para mais informações sobre a arquitetura, os clusters e as instâncias do AlloyDB, consulte Visão geral do AlloyDB.

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.

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

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.

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

Verify that billing is enabled for your Google Cloud project.

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

2. Escolha como se conectar ao AlloyDB.

gcloud

1. Crie um projeto do Google Cloud ou use um 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 foi ativado para o projeto 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 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 do AlloyDB

Observação :ao usar uma rede particular, é possível implantar tanto sua configuração de rede particular preferencial 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.

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

   Acessar Clusters

2. Clique em Criar cluster.

3. Em Configurar cluster, siga estas etapas:

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

   2. Digite uma senha. Anote essa senha porque você a usará 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.

      Observação: embora não recomendemos uma instância de zona única para produção, você pode 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.

   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. Pode levar vários minutos para o AlloyDB 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 AlloyDB Studio

Observação: para conectar um cliente psql a uma instância, siga as etapas em Conectar um cliente psql a uma instância.

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

• Saiba mais sobre outras maneiras de se conectar ao AlloyDB.

• Ative o acesso do projeto ao AlloyDB.

• Conceder acesso a outros usuários.

• Ative o acesso a serviços privados.

• Escolha um tipo de máquina do AlloyDB.

• Crie um cluster do AlloyDB e a instância principal dele.

• Saiba mais sobre as recomendações de dimensionamento.

• Conecte um cliente psql a uma instância.