Guia de início rápido do uso do proxy em testes locais

Nesta página, ensinamos como se conectar ao Cloud SQL a partir de um ambiente de teste local usando o Cloud SQL Proxy. Com uma conexão por meio do proxy, é possível testar um aplicativo do App Engine no ambiente local ou, ainda, estabelecer uma conexão segura para a administração do banco de dados.

Não use estas instruções para configurar o proxy em um ambiente de produção. Para mais opções de conexão, consulte Opções de conexão para aplicativos externos.

Antes de começar

Antes de realizar as etapas neste guia de início rápido, conclua as tarefas a seguir:

  • Crie um projeto do Google Cloud e uma instância do PostgreSQL.
  • Se você estiver usando um projeto existente, verifique se o usuário do Google Cloud é proprietário do projeto ou tem um papel do Cloud SQL que não seja Cloud SQL Viewer. Caso contrário, configure o proxy usando as instruções descritas em Como se conectar usando o Cloud SQL Proxy.
  • Outra opção é instalar o cliente psql.

    O cliente permite testar a conexão com a instância. O cliente psql pode ser instalado com o pacote do servidor ou sozinho. Veja as instruções de instalação do PostgreSQL (em inglês).

Ativar a API Cloud SQL Admin

Ative a API

Instalar e autenticar a ferramenta de linha de comando gcloud

  1. Se ainda não tiver feito isso, instale a ferramenta de linha de comando gcloud.

    Veja as instruções de instalação da gcloud.

  2. Inicialize a ferramenta gcloud:

    gcloud init
    
  3. Autentique a ferramenta gcloud:

    gcloud auth login
    

Instalar o cliente do Cloud SQL Proxy na máquina local

É necessário fazer o download do binário de proxy equivalente a seu sistema operacional, dependendo se ele usa um kernel de 32 ou 64 bits. Os modelos de hardware mais recentes usam kernel de 64 bits. Caso você não saiba se a máquina executa um kernel de 64 bits, use o comando uname -a para Linux ou macOS ou clique em Computador > Propriedades no menu "Iniciar" do Windows.

Linux de 64 bits

  1. Faça o download do proxy:
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
    
  2. Torne o proxy executável:
    chmod +x cloud_sql_proxy
    

Linux de 32 bits

  1. Faça o download do proxy:
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.386 -O cloud_sql_proxy
    
  2. Torne o proxy executável:
    chmod +x cloud_sql_proxy
    

macOS de 64 bits

  1. Faça o download do proxy:
    curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64
    
  2. Torne o proxy executável:
    chmod +x cloud_sql_proxy
    

macOS de 32 bits

  1. Faça o download do proxy:
    curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.386
    
  2. Torne o proxy executável:
    chmod +x cloud_sql_proxy
    

Windows de 64 bits

Para fazer o download do proxy, clique com o botão direito em https://dl.google.com/cloudsql/cloud_sql_proxy_x64.exe e selecione Salvar link como. Renomeie o arquivo para cloud_sql_proxy.exe.

Windows de 32 bits

Para fazer o download do proxy, clique com o botão direito em https://dl.google.com/cloudsql/cloud_sql_proxy_x86.exe e selecione Salvar link como. Renomeie o arquivo para cloud_sql_proxy.exe.
Caso seu sistema operacional não esteja incluído aqui, compile o proxy a partir da fonte.

Conseguir o nome da conexão da instância

  1. Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.

    Acessar a página "Instâncias" do Cloud SQL

  2. Clique no nome da instância para abrir a página Detalhes da instância.

  3. Em Conectar-se a esta instância, anote o Nome da conexão da instância.

Iniciar o proxy

Inicie o proxy no próprio terminal para que você possa monitorar a saída. Substitua <INSTANCE_CONNECTION_NAME> pelo nome da conexão da instância copiado no passo anterior.

./cloud_sql_proxy -instances=<INSTANCE_CONNECTION_NAME>=tcp:5432

Você verá uma mensagem semelhante a:

Listening on 127.0.0.1:5432 for myproject:us-central1:myinstance".
Ready for new connections

Conectar-se ao banco de dados usando o cliente psql

Esta seção é opcional, mas é recomendada para testar sua conexão. Veja as instruções de instalação do PostgreSQL.

Em uma janela de terminal diferente de onde você iniciou o proxy, execute o seguinte comando, substituindo <USERNAME> pelo seu nome de usuário do PostgreSQL e <DB_NAME> pelo nome do banco de dados ao qual se conectar.

psql "host=127.0.0.1 port=5432 sslmode=disable dbname=<DB_NAME> user=<USER_NAME>"

O prompt do psql aparecerá. O terminal do proxy exibirá uma mensagem como esta:

New connection for "myproject:us-central1:myinstance"

A seguir