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

Para começar a usar o AlloyDB para PostgreSQL no console do Google Cloud , crie um cluster e uma instância principal, conecte-se à instância usando o AlloyDB Studio e insira e consulte dados de amostra. No AlloyDB, os bancos de dados são armazenados em clusters que contêm instâncias. 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

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloudagora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho sem custos financeiros.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

1. A API Service Networking é necessária se você planeja configurar a conectividade de rede com o AlloyDB usando uma rede de nuvem privada virtual (VPC) que reside no mesmo projeto do Google Cloud 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 do Google Cloud diferente.

2. Escolha uma opção de conectividade.

Funções exigidas

Para receber as permissões necessárias para criar e se conectar a um banco de dados do AlloyDB, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

• Administrador de rede do Compute (roles/compute.networkAdmin)
• Administrador do AlloyDB (roles/alloydb.admin)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para criar e se conectar a um banco de dados do AlloyDB. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para criar e se conectar a um banco de dados do AlloyDB:

• compute.networks.list
• compute.networks.addPeering
• compute.addresses.create
• servicenetworking.services.addPeering
• alloydb.clusters.create
• alloydb.instances.create
• alloydb.instances.login

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Criar um cluster e a instância principal do AlloyDB dele

Observação: para configurar um cluster, uma instância e uma rede para seu ambiente de desenvolvimento usando um guia interativo, siga as etapas no codelab de configuração do AlloyDB.

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ê vai usá-la neste guia de início rápido.

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

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

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

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

   2. Em Disponibilidade por zona, selecione Zona única.

      Observação :embora não recomendemos uma instância de zona única para produção, é possível usar uma zona única 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 Tipo de máquina, selecione o tipo de máquina 2 vCPU, 16 GB.

   4. No menu Rede em Conectividade, selecione a rede default.

      Se você tiver uma conexão de acesso a serviços particulares configurada, 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, selecione Usar um intervalo de IP alocado 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 exibi-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-se pelo Compute Engine.

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ê 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 do AlloyDB.

   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, digite 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. Opcional: se você criou uma conexão de acesso a serviços particulares ao criar o cluster e não precisa mais do intervalo de endereços IP alocado, siga as etapas em Remover um intervalo alocado de acesso a serviços particulares.

A seguir

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

• Conceder acesso a outros usuários.

• Ative o acesso a serviços particulares.

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

• Conectar a partir do Compute Engine.