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 para 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 executar as etapas neste guia de início rápido, conclua as tarefas a seguir:

  • Crie um projeto do GCP e uma instância do PostgreSQL.
  • Se você estiver usando um projeto pré-existente, verifique se o usuário do GCP é 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 pelo Cloud SQL Proxy.
  • Se quiser, instale o cliente psql.

    O cliente permite testar a conexão com a instância. O cliente psql é instalado com o pacote do servidor. Se preferir, você pode instalá-lo por conta própria. Veja as instruções de instalação do PostgreSQL.

Ativar a API do Cloud SQL

Ativar Administrador do Cloud SQL API.

Ativar a API

Instalar e autenticar a ferramenta de linha de comando gcloud

  1. Se ainda não o fez, instale a ferramenta de linha de comando gcloud.

    Ver as instruções de instalação do 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. Se você não souber se a máquina executa um kernel de 64 bits, use o comando uname -a no 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

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

Windows de 32 bits

Clique com o botão direito do mouse em https://dl.google.com/cloudsql/cloud_sql_proxy_x86.exe e selecione Salvar link como para fazer o download do proxy. Renomeie o arquivo como cloud_sql_proxy.exe.
Se o seu sistema operacional não estiver incluído aqui, compile o proxy a partir da fonte (em inglês).

Conseguir o nome da conexão da instância

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

    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.

    Você usará esse valor na próxima etapa.

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 copiada na etapa 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 etapa é opcional, mas recomendamos executá-la para testar a conexão. Veja as instruções de instalação do PostgreSQL.

Execute o comando a seguir, substituindo <USERNAME> pelo seu nome de usuário do PostgreSQL e <DB_NAME> pelo nome do banco de dados a que você quer se conectar.

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

Você verá o prompt do psql. Uma mensagem semelhante ao exemplo abaixo aparecerá no terminal do proxy:

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

Próximas etapas

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Cloud SQL para PostgreSQL