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

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

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

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

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

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

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

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

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

    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.

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.

  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 (Í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?