Crie e associe a uma base de dados

Crie e associe a uma base de dados

Esta página explica o processo de criação e ligação à sua primeira base de dados no AlloyDB for PostgreSQL.

As instruções fornecidas no final deste guia de início rápido explicam como limpar esta nova base de dados. A página conclui-se com os passos seguintes para saber mais sobre a utilização do AlloyDB com as suas próprias aplicações.

Antes de começar

Consola

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 (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 (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 Cloud necessárias para criar e estabelecer ligação ao AlloyDB para PostgreSQL.

   Ative as APIs

   1. No passo Confirmar projeto, clique em Seguinte para confirmar o nome do projeto ao qual vai fazer alterações.

   2. No passo Ativar APIs, clique em Ativar para ativar o seguinte:

      • API AlloyDB
      • API Compute Engine
      • Cloud Resource Manager API
      • API de rede de serviços

      A API Service Networking é necessária se planear configurar a conetividade de rede ao AlloyDB através de uma rede VPC que resida no mesmo Google Cloud projeto que o AlloyDB.

      A API Compute Engine e a API Cloud Resource Manager são necessárias se planear configurar a conetividade de rede ao AlloyDB através de uma rede VPC que reside num projeto Google Cloud diferente.

gcloud

1. Crie um Google Cloud 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 o seguinte:

   • PROJECT_ID: o identificador permanente do projeto.

2. Certifique-se de que a faturação está ativada para o seu Google Cloud projeto. Saiba como confirmar que a faturação está ativada para o seu 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 planeia configurar a conetividade de rede para o AlloyDB através de uma rede VPC que reside no mesmo Google Cloud projeto que o AlloyDB, ative a API Service Networking no projeto.

   gcloud services enable servicenetworking.googleapis.com
   

5. Se planeia configurar a conetividade de rede ao AlloyDB através de uma rede VPC que reside num Google Cloud projeto diferente, confirme que a API Compute Engine e Service Networking nesse projeto estão ativadas para poder configurar a VPC partilhada e o acesso privado aos serviços nesse projeto.

   gcloud services list
   

Crie um cluster e a respetiva instância principal

Nota: se planeia usar redes privadas, pode implementar a configuração de redes privadas da sua escolha e a instância do AlloyDB, juntamente com clientes como VMs do Compute Engine, através do Terraform. Para mais informações, consulte o artigo Soluções de configuração de rede na nuvem simplificadas.

1. Na Google Cloud consola, aceda à página Clusters.

   Aceda a Clusters

2. Clique em Criar cluster.

3. Em Configure o cluster, siga estes passos:

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

   2. Introduza uma palavra-passe. Tome nota desta palavra-passe, pois vai usá-la neste início rápido.

   3. Manter a versão predefinida da base de dados.

   4. No menu pendente Região de Localização, selecione a região us-central1 (Iowa).

4. Em Configure a sua instância principal, siga estes passos:

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

   2. Em Disponibilidade zonal, clique em Zona única.

      Nota: embora não recomendemos uma única instância de zona para produção, pode usar uma única zona neste início rápido para minimizar os custos. Para mais informações, consulte o artigo Reduza os custos com instâncias básicas.

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

   4. No menu pendente Rede de Conetividade, selecione a rede default.

      Se tiver uma ligação de acesso privado, avance para o passo de criação de um cluster. Caso contrário, clique em Configurar associação e siga estes passos:

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

      2. Clique em Continuar e, de seguida, em Criar associação.

   5. Mantenha as predefinições em Segurança de rede.

5. Clique em Criar cluster. O AlloyDB pode demorar vários minutos a criar o cluster e apresentá-lo na página Vista geral do cluster principal.

Associe à sua instância e crie uma base de dados

1. Na Google Cloud consola, aceda à página Clusters.

   Aceda a 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 Inicie sessão no AlloyDB Studio, siga estes passos:

   1. Escolha um método de autenticação de base de dados.

   2. Selecione a base de dados postgres.

   3. Clique em Autenticar. O painel Explorador apresenta uma lista dos objetos na base de dados postgres.

5. Para criar uma base de dados, introduza a seguinte declaração no separador Editor 1 e, de seguida, clique em Executar:

   CREATE DATABASE guestbook;
   

   Sabe que a base de dados foi criada quando a mensagem Statement executed successfully é apresentada no painel Resultados.

Associe à base de dados guestbook

1. Na Google Cloud consola, aceda à página Clusters.

   Aceda a 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 Inicie sessão no AlloyDB Studio, siga estes passos:

   1. Selecione a base de dados guestbook.

   2. Selecione o utilizador postgres.

   3. Introduza a palavra-passe que criou em Crie um cluster e a respetiva instância principal.

   4. Clique em Autenticar. O painel Explorador apresenta uma lista dos objetos na base de dados guestbook.

Valide a ligação à base de dados

1. Siga os passos em Associe à base de dados guestbook.

2. Para inserir dados de amostra na base de dados guestbook, introduza o seguinte no separador 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 são inseridos na sua base de dados.

4. Para remover texto do separador Editor 1 para poder executar outro comando, clique em Limpar.

5. Para selecionar todas as entradas na base de dados, introduza a seguinte consulta no separador Editor 1:

   SELECT * FROM entries;
   

6. Clique em Executar. O resultado semelhante ao seguinte é apresentado no painel Resultados:

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

Limpar

Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

1. Na Google Cloud consola, aceda à página Clusters.

   Aceda a Clusters

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

3. Clique em Eliminar cluster.

4. Em Delete cluster my-cluster, introduza my-cluster para confirmar que quer eliminar o cluster.

5. Clique em Eliminar.

6. Se criou uma ligação privada quando criou um cluster, aceda à Google Cloud página de rede da consola e clique em Eliminar rede VPC.

O que se segue?

• Ative o acesso do projeto ao AlloyDB

• Conceda acesso a outros utilizadores

• Ative o acesso a serviços privados

• Crie um cluster e a respetiva instância principal

• Saiba mais sobre as recomendações de tamanhos