Ligue-se ao Cloud SQL para PostgreSQL a partir do Cloud Shell

Ligue-se ao Cloud SQL para PostgreSQL a partir do Cloud Shell

MySQL   |  PostgreSQL   |  SQL Server

Esta página mostra-lhe como criar e estabelecer ligação a uma instância do PostgreSQL e realizar operações SQL básicas através da consola Google Cloud e de um cliente. Normalmente, os recursos criados neste início rápido custam menos de 1 euro, desde que conclua os passos, incluindo a limpeza, atempadamente.

Antes de começar

Nota: O nome que usa para o seu projeto tem de ter entre 4 e 30 carateres. Quando escreve o nome, o formulário sugere um ID do projeto, que pode editar. O ID do projeto tem de ter entre 6 e 30 carateres, com uma letra minúscula como o primeiro caráter. Pode usar um traço, uma letra minúscula ou um dígito para os carateres restantes, mas o último caráter não pode ser um traço.

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 Google Cloud necessárias.

   Consola

   Na Google Cloud consola, aceda à página APIs.

   Aceder às APIs

   Ative a API Admin do Cloud SQL.

   gcloud

   Clique no botão seguinte para abrir o Cloud Shell, que oferece acesso à linha de comandos aos seus Google Cloud recursos diretamente a partir do navegador. Pode usar o Cloud Shell para executar os comandos gcloud apresentados ao longo deste início rápido.

   Abra o Cloud Shell

   Execute o comando gcloud services enable da seguinte forma através da Cloud Shell para ativar as APIs necessárias para este início rápido:

   gcloud services enable sqladmin.googleapis.com

   Este comando ativa as seguintes APIs:

   • API Cloud SQL Admin

2. Make sure that you have the following role or roles on the project: Cloud SQL Admin (roles/cloudsql.admin)

   Check for the roles

   1. In the Google Cloud console, go to the IAM page.

      Go to IAM
   2. Select the project.

   3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

   4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

   Grant the roles

   1. In the Google Cloud console, go to the IAM page.

      Aceder ao IAM
   2. Selecione o projeto.
   3. Clique em Conceder acesso.

   4. No campo Novos responsáveis, introduza o identificador do utilizador. Normalmente, este é o endereço de email de uma Conta Google.

   5. Na lista Selecionar uma função, selecione uma função.
   6. Para conceder funções adicionais, clique em Adicionar outra função e adicione cada função adicional.
   7. Clique em Guardar.

Crie uma instância do Cloud SQL

Neste início rápido, usa a Google Cloud consola. Para usar a CLI gcloud, o cURL ou o PowerShell, consulte o artigo Crie instâncias.

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Clique em Criar instância.
3. Clique em Escolher PostgreSQL.
4. No campo ID da instância, introduza myinstance.
5. No campo Palavra-passe, introduza uma palavra-passe para o utilizador postgres.

6. Clique em Criar instância.

   Regressa à lista de instâncias. Pode clicar imediatamente na nova instância para ver os detalhes, mas esta não vai estar disponível para outras operações até ser inicializada e iniciada.

   Nota: neste exemplo, a instância é criada com as predefinições, incluindo um endereço IP público.

Associe-se à sua instância

Neste início rápido, vamos usar o cliente psql no Cloud Shell para estabelecer ligação à sua instância. O Cloud Shell é um ambiente remoto em sandbox.

Nota: o Cloud Shell não funciona com um endereço IP privado. Estas instruções destinam-se apenas a uma instância com um endereço IP público.

1. Opcional: se estiver a executar uma instância local do PostgreSQL, pare-a antes de se ligar à instância do Cloud SQL. Caso contrário, pode encontrar erros, como address already in use.

2. Na Google Cloud consola, clique no ícone do Cloud Shell () no canto superior direito.

   Quando o Cloud Shell terminar a inicialização, é apresentada uma mensagem, como a seguinte:

   Welcome to Cloud Shell! Type "help" to get started.
   Your Cloud Platform project in this session is set to sample-project.
   Use "gcloud config set project [PROJECT_ID]" to change to a different project.
   username@sample-project:~ (sample-project)$
   

3. Opcional: se não autorizou a CLI gcloud a aceder à Google Cloud plataforma com as suas credenciais de utilizador Google, use o comando gcloud auth login.

4. Na linha de comandos do Cloud Shell, ligue-se à sua instância do Cloud SQL. Use o comando gcloud sql connect da seguinte forma. Substitua o nome da instância se o nome da instância for diferente.

   gcloud sql connect myinstance --user=postgres

5. Na caixa de diálogo, clique em Autorizar para autorizar o Cloud Shell a fazer chamadas de API.

   É apresentada a seguinte mensagem:

   Allowlisting your IP for incoming connection for 5 minutes...done.
   

   Esta mensagem indica que o endereço IP público da sua instância do Cloud SQL está a receber autorização para ter ligações de entrada. Após esta mensagem, é-lhe pedido que introduza a sua palavra-passe.

6. Introduza a sua palavra-passe do postgres.

   É apresentada a mensagem psql.

Crie uma base de dados e carregue dados

1. Crie uma base de dados SQL na sua instância do Cloud SQL:

   CREATE DATABASE guestbook;

2. Ligue-se à base de dados introduzindo o seguinte comando e especificando a sua palavra-passe.

   \connect guestbook;

3. Insira dados de amostra na base de dados:

   CREATE TABLE entries (guestName VARCHAR(255), content VARCHAR(255),
                           entryID SERIAL PRIMARY KEY);
   INSERT INTO entries (guestName, content) values ('first guest', 'I got here!');
   INSERT INTO entries (guestName, content) values ('second guest', 'Me too!');

4. Obtenha os dados:

   SELECT * FROM entries;

   O resultado é:

     guestname   |   content   | entryid
   --------------+-------------+---------
    first guest  | I got here! |       1
    second guest | Me too!     |       2
   (2 rows)
   postgres=>
   

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 Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Selecione a instância myinstance para abrir a página Detalhes da instância.
3. Na barra de ícones na parte superior da página, clique em Eliminar.
4. Na janela Eliminar instância, escreva o nome da instância e, de seguida, clique em Eliminar.

Passos de limpeza opcionais

Se não estiver a usar as APIs que foram ativadas como parte deste início rápido, pode desativá-las.

• APIs ativadas neste guia de início rápido:
  • API Cloud SQL Admin

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

   Aceder às APIs

2. Selecione a API Admin do Cloud SQL e, de seguida, clique no botão Desativar API.

O que se segue?

• Saiba como criar instâncias do Cloud SQL.

• Saiba como criar utilizadores do PostgreSQL e bases de dados para a sua instância do Cloud SQL.

• Consulte as informações de preços do Cloud SQL.

• Neste início rápido, estabeleceu ligação à instância através do Cloud Shell. Saiba mais sobre todas as opções de conetividade no Cloud SQL. A forma como se liga depende da sua configuração de rede, por exemplo, se a sua instância do Cloud SQL tem um endereço IP público ou privado. Veja como configurar a sua instância do Cloud SQL com um IP público e um endereço IP privado.

• Saiba como estabelecer ligação a uma instância do Cloud SQL a partir de outras aplicações do Google Cloud:

  • A partir de uma aplicação em execução no ambiente padrão do App Engine
  • A partir de uma aplicação em execução no Compute Engine
  • A partir de uma aplicação executada no GKE
  • Do Cloud Run