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

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

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, conectar-se à 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

Faça login na sua Google Cloud conta do. Se você começou a usar o Google Cloud, 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.

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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

A API Service Networking é necessária se você planeja configurar conectividade de rede com o AlloyDB usando uma rede VPC que reside no mesmo Google Cloud projeto do AlloyDB.

As APIs Compute Engine e API 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 diferente Google Cloud

1. Escolha como se conectar ao AlloyDB.

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 seu 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 que são necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir 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

Observação: para configurar rapidamente um cluster, uma instância e uma rede para seu ambiente de desenvolvimento usando uma interface da Web, siga as etapas neste codelab.

1. Noconsole, acesse a página Clusters. Google Cloud

   Acessar Clusters

2. Clique em Criar cluster.

3. Em Configurar cluster, siga estas etapas:

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

   2. Insira 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 Localização, 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, clique em Zona única.

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

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

      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 IP 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 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 um cliente psql a uma instância.

1. Noconsole, acesse a página Clusters. Google Cloud

   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 do 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 instrução a seguir na guia Editor 1 e clique em Executar:

   CREATE DATABASE guestbook;
   

   Você sabe que o banco de dados foi criado quando a mensagem Statement executed successfully aparece no painel Resultados.

Conectar-se ao banco de dados guestbook

1. Noconsole, acesse a página Clusters. Google Cloud

   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 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 Resultados indica que os dados foram inseridos no banco de dados.

4. Para remover o texto da guia Editor 1 para que você possa executar outro comando, clique em Limpar.

5. Para selecionar todas as entradas no banco de dados, insira a consulta a seguir 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
   

Liberar espaço

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

1. Noconsole, acesse a página Clusters. Google Cloud

   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 Google Cloud Rede doconsole e clique em Excluir rede VPC.

A seguir

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

• Ativar o acesso do projeto ao AlloyDB.

• Conceder acesso a outros usuários.

• Ativar o acesso a serviços particulares.

• Escolher um tipo de máquina do AlloyDB.

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

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

• Conectar um cliente psql a uma instância.