Conectar-se ao Cloud SQL para PostgreSQL pelo Cloud Shell

Nesta página, você verá como criar e se conectar a uma instância do PostgreSQL, além de executar operações SQL básicas usando o Console do Google Cloud e um cliente. Os recursos criados neste guia de início rápido normalmente custam menos de um dólar, supondo que você conclua as etapas, incluindo a limpeza, em tempo hábil.

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.

    Go to project selector

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  5. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  6. Ative as APIs do Google Cloud necessárias.

    Console

    No console do Google Cloud, acesse a página APIs.

    Acesse APIs

    Ative a API Cloud SQL Admin.

    gcloud

    Clique no botão a seguir para abrir o Cloud Shell, que fornece acesso de linha de comando aos recursos do Google Cloud diretamente no navegador. O Cloud Shell pode ser usado para executar os comandos gcloud apresentados neste guia de início rápido.

    Abra o Cloud Shell

    Execute o comando gcloud services enable da seguinte maneira usando o Cloud Shell para ativar as APIs necessárias para este guia de início rápido:

    gcloud services enable sqladmin.googleapis.com

    Esse comando ativa as seguintes APIs:

    • API Cloud SQL Admin

Criar uma instância do Cloud SQL

Neste guia de início rápido, você usa o console do Google Cloud. Para usar a CLI gcloud, o cURL ou o PowerShell, consulte Criar instâncias.

  1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique em Criar instância.
  3. Clique em Escolher PostgreSQL.
  4. Insira myinstance para o ID da instância.
  5. Digite a senha do usuário postgres.
  6. Clique em Criar.

    Você retornará à lista de instâncias. É possível clicar na nova instância imediatamente para ver os detalhes, mas ela não estará disponível para outras operações até que seja inicializada.

Conecte-se à instância

Neste guia de início rápido, usaremos o cliente psql no Cloud Shell para se conectar à instância.

  1. Opcional: se você estiver executando uma instância local do PostgreSQL, interrompa-a antes de se conectar à instância do Cloud SQL. Caso contrário, poderão ocorrer erros como address already in use.
  2. No Console do Google Cloud, clique no ícone do Cloud Shell (Ícone do Cloud Shell.) no canto superior direito.

    Quando o Cloud Shell concluir a inicialização, será exibida uma mensagem como esta:

    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. No prompt do Cloud Shell, conecte-se à instância do Cloud SQL. Use o comando gcloud sql connect da seguinte maneira. Substitua o nome da instância se o nome dela for diferente.

    gcloud sql connect myinstance --user=postgres
  4. Clique em Autorizar na caixa de mensagem para autorizar o Cloud Shell a fazer chamadas de API.

    Uma mensagem indica que o IP está sendo permitido para conexões de entrada. Depois disso, você precisará inserir sua senha.

  5. Insira a senha do postgres.

    Será exibida a solicitação psql.

Criar um banco de dados e fazer upload de dados

  1. Crie um banco de dados SQL na sua instância do Cloud SQL:
    CREATE DATABASE guestbook;
  2. Conecte-se ao banco de dados inserindo o comando a seguir e especificando sua senha.
    \connect guestbook;
  3. Insira dados de amostra no banco 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. Recupere os dados:
    SELECT * FROM entries;
    O resultado será:
      guestname   |   content   | entryid
    --------------+-------------+---------
     first guest  | I got here! |       1
     second guest | Me too!     |       2
    (2 rows)
    postgres=>
    

Limpar

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

  1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

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

Etapas de limpeza opcionais

Se você não estiver usando as APIs que foram ativadas como parte deste guia de início rápido, é possível desativá-las.

  • APIs que foram ativadas neste guia de início rápido:
    • API Cloud SQL Admin
  1. No console do Google Cloud, acesse a página APIs.

    Acesse APIs

  2. Selecione a API Cloud SQL Admin e clique no botão Desativar API.

A seguir