Conectar-se a uma origem do Cloud SQL-MySQL

Nesta página, descrevemos como conectar uma instância privada do Cloud Data Fusion a uma instância particular do Cloud SQL que hospeda um banco de dados MySQL. Uma configuração semelhante funciona para instâncias do Postgres e do SQL Server. É possível estabelecer conexões públicas.

Recomendado: por motivos de segurança, use instâncias particulares do Cloud SQL e do Cloud Data Fusion.

Crie instâncias particulares no Cloud Data Fusion e no Cloud SQL

Para se conectar a uma instância particular do Cloud SQL a partir de uma instância particular do Cloud Data Fusion, use uma VM de proxy do Compute Engine. Um proxy é necessário porque a rede do Cloud SQL não tem peering direto com a rede do Cloud Data Fusion e os pares transitivos não podem se comunicar entre si. Consulte a Visão geral do peering de rede VPC.

Para criar as instâncias particulares, siga estas etapas:

  1. Se você ainda não tiver uma, crie uma instância particular do Cloud Data Fusion. Incluindo:

    1. Como configurar uma rede VPC
    2. Como alocar um intervalo de IP
  2. Crie uma instância privada do Cloud SQL na mesma rede VPC que a instância do Cloud Data Fusion.

  3. Depois que a instância for criada, acesse a página Instâncias do Cloud SQL e expanda os Detalhes da instância. Na seção Conectar-se a esta instância, copie o IP e o nome da conexão.

    Acessar "Instâncias do Cloud SQL"

Criar uma VM particular do Compute Engine

Para criar a VM, insira os comandos a seguir no Cloud Shell ou em outro ambiente em que o SDK Google Cloud esteja instalado.

Os comandos criam uma VM com endereços IP internos e públicos (--no-address não está especificado no comando de criação de VM de amostra) para que a VM possa acessar o Container Registry e receber a imagem do proxy. É possível usar IPs internos, mas também é necessário ativar o Acesso privado do Google para a sub-rede em que a VM está localizada.

  1. Exporte as seguintes variáveis de ambiente:

    export PROJECT=CUSTOMER_PROJECT
    export REGION=VM_REGION
    export ZONE=`gcloud compute zones list --filter="name=${REGION}" --limit 1 --uri --project=${PROJECT}| sed 's/.*\///'`
    export NETWORK=CUSTOMER_VPC_NETWORK_NAME
    export SUBNET=CUSTOMER_VPC_SUBNET_NAME
    export INSTANCE_NAME=COMPUTE_ENGINE_VM_NAME
    export SQL_CONN=SQL_INSTANCE_CONNECTION_NAME
    export CDF_IP_RANGE=CLOUD_DATA_FUSION_IP_RANGE
    export VM_IMAGE=$(gcloud compute images list --project=$PROJECT | grep cos-stable | awk 'FNR == 1 {print $1}')
    export SQL_PORT=DB_PORT # MySQL 3306 # PostgreSQL 5432 # SQLServer 1433
    

    Substitua:

    • CUSTOMER_PROJECT: o nome do projeto
    • VM_REGION: a região em que a VM do Compute Engine está localizada
    • CUSTOMER_VPC_NETWORK_NAME: o nome da rede.
    • CUSTOMER_VPC_SUBNET_NAME: o nome da sub-rede.
    • COMPUTE_ENGINE_VM_NAME: o nome da VM do Compute Engine
    • SQL_INSTANCE_CONNECTION_NAME: o nome da conexão da etapa anterior
    • CLOUD_DATA_FUSION_IP_RANGE: o intervalo de endereços IP
    • DB_PORT: o número da porta do banco de dados do Cloud SQL
  2. Crie uma regra de firewall para permitir o tráfego de entrada do Cloud Data Fusion com o seguinte comando da CLI gcloud:

    gcloud compute firewall-rules create allow-private-cdf \
    --allow=tcp:22,tcp:${SQL_PORT} \
    --source-ranges=$CDF_IP_RANGE --network=$NETWORK --project=$PROJECT
    
  3. Crie a VM com o seguinte comando da CLI gcloud:

    gcloud compute --project=${PROJECT} instances create ${INSTANCE_NAME} \
    --zone=${ZONE} \
    --machine-type=g1-small \
    --subnet=${SUBNET} \
    --metadata=startup-script="docker run -d -p 0.0.0.0:${SQL_PORT}:${SQL_PORT} gcr.io/cloudsql-docker/gce-proxy:latest /cloud_sql_proxy -instances=${SQL_CONN}=tcp:0.0.0.0:${SQL_PORT}" \
    --maintenance-policy=MIGRATE \
    --scopes=https://www.googleapis.com/auth/cloud-platform \
    --image=${VM_IMAGE} \
    --image-project=cos-cloud
    
  4. Consiga o IP interno da VM com o seguinte comando da CLI gcloud:

    export IP=`gcloud compute \
    --project=${PROJECT} instances describe ${INSTANCE_NAME} \
    --zone ${ZONE} | grep "networkIP" | awk '{print $2}'`
    
  5. Promova o IP interno da VM a um IP estático com o seguinte comando da CLI gcloud:

    gcloud compute --project=${PROJECT} addresses create mysql-proxy \
    --addresses ${IP} --region ${REGION} --subnet ${SUBNET}
    
  6. Consiga o IP a ser usado na string de conexão JDBC do MySQL do Cloud Data Fusion ao configurar a conexão:

    echo ${IP}
    

Depois que a VM for criada com um IP estático, use o IP como o host ou insira-o na string de conexão JDBC para acessar o banco de dados MySQL do Cloud Data Fusion.

Acessar o MySQL de dentro do Cloud Data Fusion

Antes de se conectar à instância do MySQL pela instância do Cloud Data Fusion, instale o driver JDBC do MySQL do Cloud Data Fusion Hub (ou diretamente dos downloads da comunidade do MySQL).

Insira os detalhes da conexão do seu banco de dados MySQL no Cloud Data Fusion. Você pode inserir os detalhes e testar a conexão na página do Wrangler.

Opcional: outras maneiras de se conectar ao MySQL

É possível acessar o MySQL das seguintes maneiras no Cloud Data Fusion:

  • Na página Studio, clique no plug-in de origem do MySQL e insira os detalhes da conexão.
  • Na página Studio, use o plug-in de origem do Database, que tem propriedades semelhantes (String de conexão, Nome de usuário, Senha e Argumentos de conexão).

Outras conexões

Embora a conexão de instâncias particulares seja recomendada, as seguintes conexões são possíveis:

  • Uma instância pública do Cloud Data Fusion para uma instância pública do Cloud SQL usando um proxy público do Cloud SQL ou colocando o intervalo 0.0.0.0/0 na lista de permissões em uma rede autorizada Veja a opção de conexão de IP público para o Cloud SQL.
  • Uma instância particular do Cloud Data Fusion e uma instância pública do Cloud SQL usando um proxy público do Cloud SQL em uma rede autorizada.
  • Uma instância pública do Cloud Data Fusion e uma instância privada do Cloud SQL.