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 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 Cloud SQL.
- Se você estiver usando um projeto atual, 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 pelo Cloud SQL Proxy. Outra opção é instalar o cliente
mysql
.O cliente permite testar a conexão com a instância. É possível instalar o cliente
mysql
com o pacote do servidor. Alguns sistemas operacionais aceitam pacotes apenas de cliente. Veja as instruções de instalação do MySQL.
Ativar a API Cloud SQL Admin
Instalar e autenticar a ferramenta de linha de comando gcloud
Se ainda não tiver feito isso, instale a ferramenta de linha de comando
gcloud
.Inicialize a ferramenta
gcloud
:gcloud init
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
- Faça o download do proxy:
wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
- Torne o proxy executável:
chmod +x cloud_sql_proxy
Linux de 32 bits
- Faça o download do proxy:
wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.386 -O cloud_sql_proxy
- Torne o proxy executável:
chmod +x cloud_sql_proxy
macOS de 64 bits
- Faça o download do proxy:
curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64
- Torne o proxy executável:
chmod +x cloud_sql_proxy
macOS de 32 bits
- Faça o download do proxy:
curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.386
- 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 paracloud_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 paracloud_sql_proxy.exe
.
Conseguir o nome da conexão da instância
Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.
Clique no nome da instância para abrir a página Detalhes da instância.
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:3306
Você verá uma mensagem semelhante a esta:
Listening on 127.0.0.1:3306 for myproject:us-central1:myinstance". Ready for new connections
Conectar-se ao banco de dados usando o cliente mysql
Esta seção é opcional, mas é recomendada para testar sua conexão. Veja as instruções de instalação do MySQL.
Em uma janela de terminal diferente da que você iniciou o proxy, execute o comando a seguir, substituindo<USERNAME>
pelo seu nome de usuário do MySQL.
mysql -u <USERNAME> -p --host 127.0.0.1 --port 3306
O prompt mysql é exibido, e uma mensagem semelhante à seguinte estará no terminal do proxy:
New connection for "myproject:us-central1:myinstance"
Limpar
Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste guia de início rápido, siga estas etapas:
- Acesse a página "Instâncias" do Cloud SQL no Console do Google Cloud.
Acessar a página "Instâncias" do Cloud SQL - Selecione a instância do
myinstance
para abrir a página Detalhes da instância. - Na barra de ícones na parte superior da página, clique em Excluir.
Na janela Excluir instância, digite
myinstance
e clique em Excluir para excluir a instância.Após a exclusão da instância, o respectivo nome não poderá ser usado por aproximadamente sete dias.