Conectar-se ao Cloud SQL para MySQL pelo computador local

Conectar-se ao Cloud SQL para MySQL pelo computador local

MySQL   |  PostgreSQL   |  SQL Server

Saiba como implantar um app de exemplo em um computador local com Linux, macOS ou Windows conectado a uma instância do MySQL usando o console do Google Cloud e um aplicativo cliente.

Supondo que você conclua todas as etapas em tempo hábil, os recursos criados neste guia de início rápido normalmente custam menos de um dólar (USD).

Antes de começar

Observação: o nome usado para seu projeto precisa ter entre 4 e 30 caracteres. Quando você digita o nome, o formulário sugere um ID do projeto, que pode ser editado. O ID do projeto precisa ter entre 6 e 30 caracteres, com uma letra minúscula como primeiro caractere. É possível usar um traço, uma letra minúscula ou um dígito para os caracteres restantes, mas o último caractere não pode ser um traço.

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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the 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 Cloud necessárias para executar um app de exemplo do Cloud SQL no computador local.

   Console

   Clique no botão Ativar APIs para ativar as APIs necessárias para este guia de início rápido.

   Ative as APIs

   Isso permite as seguintes APIs:

   • API Cloud SQL Admin
   • API IAM

   gcloud

   Instale a CLI gcloud, que fornece acesso de linha de comando aos recursos do Google Cloud. A CLI gcloud é usada para executar os comandos gcloud CLI apresentados neste guia de início rápido. Todos os comandos são formatados para serem executados em um terminal Linux/macOS ou no Windows PowerShell.

   Abra o terminal e execute o seguinte comando gcloud:

   gcloud services enable sqladmin.googleapis.com iam.googleapis.com

   Esse comando ativa as seguintes APIs:

   • API Cloud SQL Admin
   • API IAM

Configurar o Cloud SQL

crie uma instância do Cloud SQL

Console

Criar uma instância com um endereço IP público

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 MySQL.
4. Insira quickstart-instance para o ID da instância.
5. Digite a senha do usuário raiz. Salve essa senha para uso futuro.
6. Clique na opção Zona única em Escolher disponibilidade por região e zona.
7. Clique e expanda a seção Mostrar opções de configuração.
8. No menu suspenso Tipo de máquina, selecione Leve.

9. Clique em Criar instância e aguarde até que a instância seja inicializada.

gcloud

Criar uma instância com um endereço IP público

Antes de executar o comando gcloud sql instances create da seguinte maneira, substitua DB_ROOT_PASSWORD pela senha do usuário do banco de dados.

Se quiser, modifique os valores dos seguintes parâmetros:

• --database_version: o tipo e a versão do mecanismo de banco de dados. Se não for especificado, a API padrão será usada. Consulte a documentação das versões de banco de dados do gcloud para ver as versões atuais disponíveis.
• --cpu: o número de núcleos a serem definidos na máquina.
• --memory: todo o valor numérico que indica a quantidade de memória a ser definida na máquina. Uma unidade de tamanho precisa ser fornecida (por exemplo, 3.072 MB ou 9 GB). Se nenhuma unidade for especificada, é considerado o GB.
• --region: local regional da instância (por exemplo, asia-east1, us-east1). Se não houver especificação, o padrão us-central é usado. Veja a lista completa de regiões.

Execute o comando gcloud sql instances create para criar uma instância do Cloud SQL.

gcloud sql instances create quickstart-instance --database-version=MYSQL_8_0 --cpu=1 --memory=4GB --region=us-central1 --root-password=DB_ROOT_PASSWORD

Criar um banco de dados

Console

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

   Acesse Instâncias do Cloud SQL

2. Selecione quickstart-instance.
3. Abra a guia Bancos de dados.
4. Clique em Criar banco de dados.
1. Na caixa de diálogo Criar um banco de dados, insira quickstart_db como o nome do banco de dados e, se quiser, o conjunto de caracteres e a compilação.
2. Clique em Criar.

gcloud

Execute o comando gcloud sql databases create para criar um banco de dados.

gcloud sql databases create quickstart_db --instance=quickstart-instance

Criar um usuário

Console

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

   Acesse "Instâncias do Cloud SQL"

2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
3. Selecione Usuários no menu de navegação do SQL.
4. Clique em Adicionar conta de usuário.
• Na página Adicionar uma conta de usuário à instância instance_name, adicione as seguintes informações:
  • Nome de usuário: defina como quickstart-user;
  • Senha: especifique uma senha para o usuário do banco de dados; Anote-a para usá-la em uma etapa posterior deste guia de início rápido.
  • Na seção Nome do host, o padrão é Permitir qualquer host, o que significa que o usuário pode se conectar de qualquer endereço IP.

    Opcionalmente, selecione Restringir host por endereço IP ou intervalo de endereços e insira um endereço IP ou intervalo de endereços na seção Host. Assim, o usuário só poderá se conectar pelo endereço IP especificado.

5. Clique em Add.

gcloud

Substitua:

1. PASSWORD por uma senha para seu usuário do banco de dados. Anote-a para usá-la em uma etapa posterior deste guia de início rápido.

Execute o comando gcloud sql users create para criar o usuário.

gcloud sql users create quickstart-user --instance=quickstart-instance --password=PASSWORD

Os limites de tamanho de nome de usuário são os mesmos do Cloud SQL e do MySQL no local. O limite é de 32 caracteres no MySQL 8.0 e 16 caracteres nas versões anteriores.

Configurar uma conta de serviço

Crie e configure uma conta de serviço do Google Cloud que tenha o papel Cliente do Cloud SQL com permissões para se conectar ao Cloud SQL. Depois de criar uma conta de serviço, talvez seja necessário aguardar 60 segundos ou mais para usar essa conta.

Console

Criar uma conta de serviço

1. No Console do Google Cloud, acesse a página Criar conta de serviço.

Acesse "Criar conta de serviço"

2. Selecione um projeto do Google Cloud.
3. Insira quickstart-service-account como o nome da conta de serviço.
4. Opcional: digite uma descrição da conta de serviço.
5. Clique em Criar e continuar e avance para a próxima etapa.
6. Escolha o papel de Cliente do Cloud SQL a ser concedido à conta de serviço no projeto.
7. Clique em Continuar.
8. Clique em Concluído para terminar a criação da conta de serviço.

Criar e fazer o download do arquivo de chave da conta de serviço

1. No Console do Google Cloud, acesse a página Contas de serviço.

Acesse as Contas de serviço

2. Selecione um projeto.
3. Clique no endereço de e-mail da conta de serviço quickstart-service-account para a qual você quer criar uma chave.
4. Clique na guia Chaves.
5. Clique no menu suspenso Adicionar chave e selecione Criar nova chave.
6. Selecione JSON como o Tipo de chave e clique em Criar.

Clique em Criar para fazer o download de um arquivo de chave da conta de serviço. Após fazer o download do arquivo de chave, não será possível fazer o download novamente.

Armazene o arquivo de chave com segurança, porque ele pode ser usado como sua conta de serviço para autenticação. Mova e renomeie esse arquivo como quiser.

gcloud

Criar uma conta de serviço

1. Para criar a conta de serviço, execute o comando gcloud iam service-accounts create:

gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

Substitua o seguinte valor:

• DESCRIPTION: uma descrição opcional da conta de serviço.
2. Para conceder o papel de cliente do Cloud SQL à sua conta de serviço no projeto, execute o comando gcloud projects add-iam-policy-binding. Substitua PROJECT_ID pelo ID do projeto do Google Cloud:

   gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client"

Criar e fazer o download do arquivo de chave da conta de serviço

Para usar a conta de serviço recém-criada no computador local, é necessário um arquivo de chave da conta de serviço para autenticar o aplicativo de exemplo como a conta de serviço. Para criar e fazer o download do arquivo de chave da conta de serviço, execute o comando gcloud iam service-accounts keys create:

gcloud iam service-accounts keys create KEY_FILE --iam-account=quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com

Substitua os seguintes valores:

• KEY_FILE: o caminho para um novo arquivo de saída para a chave privada. Por exemplo, ~/sa-private-key.json.
• PROJECT_ID pelo ID do projeto no Google Cloud.

O download do arquivo de chave da conta de serviço foi feito no computador local. Após fazer o download do arquivo de chave, não será possível fazer o download novamente.

Armazene o arquivo de chave com segurança, porque qualquer pessoa pode usá-lo como sua conta de serviço para autenticação. Mova e renomeie esse arquivo como quiser.

Configurar o ambiente de desenvolvimento para a linguagem de programação

Configure o ambiente de desenvolvimento do computador local para a linguagem de programação de sua preferência.

Go

Conclua as etapas a seguir para configurar o ambiente de desenvolvimento e executar o app de exemplo em Go.

1. Acesse o guia de configuração de um ambiente de desenvolvimento em Go.
2. Siga as instruções na seção Instalar Go.

Java

Conclua as etapas a seguir para configurar seu ambiente de desenvolvimento e executar o app de exemplo em Java.

1. Acesse o guia de configuração de um ambiente de desenvolvimento em Java.
2. Siga as instruções da seção Instalar um JDK (Java Development Kit).
3. Conclua as instruções em Instalar uma ferramenta de automação de build para configurar o Apache Maven.

Node.js

Conclua as etapas a seguir para configurar o ambiente de desenvolvimento e executar o app de exemplo em Node.js.

1. Acesse o guia de configuração de um ambiente de desenvolvimento em Node.js.
2. Siga as instruções na seção Como instalar o Node.js e o npm.

Python

Conclua as etapas a seguir para configurar seu ambiente de desenvolvimento para executar o app de exemplo em Python.

1. Acesse o guia de configuração de um ambiente para desenvolvedores do Python.
2. Siga as instruções na seção Como instalar o Python.

Instalar o Git

Instale o Git, um sistema de controle de versões de código aberto.

Linux

Siga a documentação de instalação oficial do Git para Linux.

macOS

Siga a documentação de instalação oficial do Git para macOS.

Windows

Siga a documentação de instalação oficial do Git para Windows.

Clonar um aplicativo de exemplo

Clone um app de exemplo no computador local usando o comando git clone.

Go

Execute os seguintes comandos para clonar o app de exemplo em Go no computador local e alterar o diretório para o diretório que contém o app de exemplo.

1. Clone o app de exemplo:

   git clone https://github.com/GoogleCloudPlatform/golang-samples

2. Altere o diretório para o diretório que contém o app de exemplo.

   cd golang-samples/cloudsql/mysql/database-sql

Java

Execute os seguintes comandos para clonar o app de exemplo em Java no computador local e alterar o diretório para o diretório que contém o app de exemplo.

1. Clone o app de exemplo:

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples

2. Altere o diretório para o diretório que contém o app de exemplo.

   cd java-docs-samples/cloud-sql/mysql/servlet

Node.js

Execute os seguintes comandos para clonar o app de exemplo em Node.js no computador local e alterar o diretório para o diretório que contém o app de exemplo.

1. Clone o app de exemplo:

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples

2. Altere o diretório para o diretório que contém o app de exemplo.

   cd nodejs-docs-samples/cloud-sql/mysql/mysql

Python

Execute os seguintes comandos para clonar o app de exemplo em Python no computador local e alterar o diretório para o diretório que contém o app de exemplo.

1. Clone o app de exemplo:

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples

2. Altere o diretório para o diretório que contém o app de exemplo.

   cd python-docs-samples/cloud-sql/mysql/sqlalchemy

Configurar e executar o app de exemplo

Configurar e executar o app de exemplo

Linux/macOS

Go

Abra o terminal e execute os comandos a seguir para inicializar as variáveis de ambiente necessárias para executar o app de exemplo. Antes de executar os comandos, substitua:

• CREDENTIALS_JSON_FILE pelo caminho do arquivo de chave de credenciais JSON da sua conta de serviço usando um formato como /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME pelo Nome da conexão da instância que aparece na página Visão geral da instância do Cloud SQL.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='3306'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

Execute os comandos a seguir para fazer o download das dependências do app de exemplo em Go no computador local e executar o app de exemplo.

1. Consiga as dependências necessárias para executar o app de exemplo.

   go get ./...
   

2. Execute o app de exemplo.

   go run cmd/app/main.go
   

3. Veja o app de exemplo em execução. Abra uma janela do navegador e acesse http://127.0.0.1:8080.

   

4. Para interromper o app de exemplo, pressione Control+C na janela do terminal em que você iniciou o app de exemplo.

Java

Execute os comandos a seguir para inicializar as variáveis de ambiente necessárias para executar o app de exemplo. Antes de executar os comandos, substitua:

• CREDENTIALS_JSON_FILE pelo caminho do arquivo de chave de credenciais JSON da sua conta de serviço usando um formato como /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME pelo Nome da conexão da instância que aparece na página Visão geral da instância do Cloud SQL.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='3306'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

1. Execute o comando a seguir para ver as dependências do app de exemplo em Java no computador local e executar o app de exemplo.

   mvn jetty:run
   

2. Veja o app de exemplo em execução. Abra uma janela do navegador e acesse http://127.0.0.1:8080.

   

3. Para interromper o app de exemplo, pressione Control+C na janela do terminal em que você iniciou o app de exemplo.

Node.js

1. Execute os comandos a seguir para inicializar as variáveis de ambiente necessárias para executar o app de exemplo. Antes de executar os comandos, substitua:

   • CREDENTIALS_JSON_FILE pelo caminho do arquivo de chave de credenciais JSON da sua conta de serviço usando um formato como /path/to/service/account/key.json.
   • YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

   export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
   export INSTANCE_HOST='127.0.0.1'
   export DB_PORT='3306'
   export DB_NAME='quickstart_db'
   export DB_USER='quickstart-user'
   export DB_PASS='YOUR_DB_PASSWORD'
   

2. Faça o download do proxy do Cloud SQL Auth.

   curl -o cloud-sql-proxy \
   https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.linux.amd64

3. Execute o proxy do Cloud SQL Auth como um processo em segundo plano. Substitua INSTANCE_CONNECTION_NAME pelo Nome da conexão da instância que aparece na página Visão geral da instância do Cloud SQL.

   ./cloud-sql-proxy \
   --credentials-file $GOOGLE_APPLICATION_CREDENTIALS \
   INSTANCE_CONNECTION_NAME &

Observação: o processo que executa o proxy do Cloud SQL Auth em segundo plano pode ser interrompido usando o comando fg na janela do terminal em que você iniciou o app de exemplo. Isso coloca o job do proxy do Cloud SQL Auth em execução em primeiro plano no terminal. Em seguida, pressione Control+C para interromper o job do proxy.

Execute os comandos a seguir para ver os pacotes Node.js necessários no computador local e executar o app de exemplo.

1. Instale os pacotes Node.js necessários para executar o aplicativo localmente.

   npm install
   

2. Execute o app de exemplo.

   npm start
   

3. Veja o app de exemplo em execução. Abra uma janela do navegador e acesse http://127.0.0.1:8080.

   

4. Para interromper o app de exemplo, pressione Control+C na janela do terminal em que você iniciou o app de exemplo.

Python

Execute os comandos a seguir para inicializar as variáveis de ambiente necessárias para executar o app de exemplo. Antes de executar os comandos, substitua:

• CREDENTIALS_JSON_FILE pelo caminho do arquivo de chave de credenciais JSON da sua conta de serviço usando um formato como /path/to/service/account/key.json.
• INSTANCE_CONNECTION_NAME pelo Nome da conexão da instância que aparece na página Visão geral da instância do Cloud SQL.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

export GOOGLE_APPLICATION_CREDENTIALS=CREDENTIALS_JSON_FILE
export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='3306'
export DB_NAME='quickstart_db'
export DB_USER='quickstart-user'
export DB_PASS='YOUR_DB_PASSWORD'

Execute os comandos a seguir para ver os requisitos do app de exemplo em Python no computador local e executar o app de exemplo.

1. Inicializar um ambiente virtual e instalar os requisitos para executar o app de exemplo

   python3 -m venv env
   source env/bin/activate
   pip install -r requirements.txt
   

2. Execute o app de exemplo.

   python app.py
   

3. Veja o app de exemplo em execução. Abra uma janela do navegador e acesse http://127.0.0.1:8080.

   

4. Para interromper o app de exemplo, pressione Control+C na janela do terminal em que você iniciou o app de exemplo.

Windows

Go

Execute os comandos a seguir para inicializar as variáveis de ambiente necessárias para executar o app de exemplo. Antes de executar os comandos, substitua:

• CREDENTIALS_JSON_FILE pelo caminho do arquivo de chave de credenciais JSON da sua conta de serviço usando um formato como C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME pelo Nome da conexão da instância que aparece na página Visão geral da instância do Cloud SQL.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="3306"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

Execute os comandos a seguir para fazer o download das dependências do app de exemplo em Go no computador local e executar o app de exemplo.

1. Consiga as dependências necessárias para executar o app de exemplo.

   go get ./...
   

2. Execute o app de exemplo.

   go run cmd\app\main.go
   

3. Veja o app de exemplo em execução. Abra uma janela do navegador e acesse http://127.0.0.1:8080.

   

4. Para interromper o app de exemplo, pressione Control+C na janela do Powershell em que você iniciou o app de exemplo.

Java

Execute os comandos a seguir para inicializar as variáveis de ambiente necessárias para executar o app de exemplo. Antes de executar os comandos, substitua:

• CREDENTIALS_JSON_FILE pelo caminho do arquivo de chave de credenciais JSON da sua conta de serviço usando um formato como C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME pelo Nome da conexão da instância que aparece na página Visão geral da instância do Cloud SQL.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="3306"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

1. Execute o comando a seguir para ver as dependências do app de exemplo em Java no computador local e executar o app de exemplo.

   mvn jetty:run
   

2. Veja o app de exemplo em execução. Abra uma janela do navegador e acesse http://127.0.0.1:8080.

   

3. Para interromper o app de exemplo, pressione Control+C na janela do Powershell em que você iniciou o app de exemplo.

Node.js

1. Execute os comandos a seguir para inicializar as variáveis de ambiente necessárias para executar o app de exemplo. Antes de executar os comandos, substitua:

   • CREDENTIALS_JSON_FILE pelo caminho do arquivo de chave de credenciais JSON da sua conta de serviço usando um formato como C:\Users\Your-Username\Downloads\key.json.
   • YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

   $env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
   $env:INSTANCE_HOST="127.0.0.1"
   $env:DB_PORT="3306"
   $env:DB_NAME="quickstart_db"
   $env:DB_USER="quickstart-user"
   $env:DB_PASS="YOUR_DB_PASSWORD"
   

2. Faça o download do proxy do Cloud SQL Auth.

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.x64.exe
   -O cloud-sql-proxy.exe

3. Execute o proxy do Cloud SQL Auth como um processo em segundo plano. Substitua INSTANCE_CONNECTION_NAME pelo Nome da conexão da instância que aparece na página Visão geral da instância do Cloud SQL.

   Start-Process -filepath  ".\cloud-sql-proxy.exe" -ArgumentList `
   "--credentials-file $env:GOOGLE_APPLICATION_CREDENTIALS" INSTANCE_CONNECTION_NAME

Observação: o processo que executa o proxy do Cloud SQL Auth em segundo plano pode ser interrompido selecionando a janela cmd.exe que foi gerada pelo comando Start-Process. Feche a janela para interromper o job do proxy.

Execute os comandos a seguir para ver os pacotes Node.js necessários no computador local e executar o app de exemplo.

1. Instale os pacotes Node.js necessários para executar o aplicativo localmente.

   npm install
   

2. Execute o app de exemplo.

   npm start
   

3. Veja o app de exemplo em execução. Abra uma janela do navegador e acesse http://127.0.0.1:8080.

   

4. Para interromper o app de exemplo, pressione Control+C na janela do Powershell em que você iniciou o app de exemplo.

Python

Execute os comandos a seguir para inicializar as variáveis de ambiente necessárias para executar o app de exemplo. Antes de executar os comandos, substitua:

• CREDENTIALS_JSON_FILE pelo caminho do arquivo de chave de credenciais JSON da sua conta de serviço usando um formato como C:\Users\Your-Username\Downloads\key.json.
• INSTANCE_CONNECTION_NAME pelo Nome da conexão da instância que aparece na página Visão geral da instância do Cloud SQL.
• YOUR_DB_PASSWORD pela senha do quickstart-user que você criou na etapa anterior do guia de início rápido Criar um usuário.

$env:GOOGLE_APPLICATION_CREDENTIALS="CREDENTIALS_JSON_FILE"
$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="3306"
$env:DB_NAME="quickstart_db"
$env:DB_USER="quickstart-user"
$env:DB_PASS="YOUR_DB_PASSWORD"

Execute os comandos a seguir para ver os requisitos do app de exemplo em Python no computador local e executar o app de exemplo.

1. Inicializar um ambiente virtual e instalar os requisitos para executar o app de exemplo

   virtualenv --python python3 env
   .\env\Scripts\activate
   pip install -r requirements.txt
   

2. Execute o app de exemplo.

   python app.py
   

3. Veja o app de exemplo em execução. Abra uma janela do navegador e acesse http://127.0.0.1:8080.

   

4. Para interromper o app de exemplo, pressione Control+C na janela do Powershell em que você iniciou o app de exemplo.

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 quickstart-instance 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 caixa de diálogo Excluir instância, digite quickstart-instance e clique em Excluir para excluir a instância.

Etapas de limpeza opcionais

Se você não estiver usando o papel Cliente do Cloud SQL que foi atribuído à conta de serviço quickstart-service-account, remova-o.

1. No console do Google Cloud, abra a página IAM.

   Acessar IAM

2. Clique no ícone de edição (parecido com um lápis) da conta do IAM chamada quickstart-service-account.
3. Exclua o papel Cliente do Cloud SQL.
4. Clique em Save.

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
  • API Identity and Access Management

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

   Acesse APIs

2. Selecione qualquer API que você quer desativar e clique no botão Desativar API.

A seguir

Com base nas suas necessidades, é possível saber mais sobre como criar instâncias do Cloud SQL.

Também é possível aprender sobre como criar usuários do MySQL e bancos de dados para sua instância do Cloud SQL.

Para mais informações sobre preços, consulte Preços do Cloud SQL para MySQL.

Saiba mais sobre estas situações:

• Como configurar sua instância do Cloud SQL com um endereço IP público.
• Como configurar sua instância do Cloud SQL com um endereço IP privado.

Além disso, é possível aprender a se conectar a uma instância do Cloud SQL usando outros aplicativos do Google Cloud, como:

• Um aplicativo em execução no ambiente padrão do App Engine
• A partir de um aplicativo em execução no Compute Engine
• a partir de um aplicativo em execução no GKE;
• no Cloud Functions.
• no Cloud Run