Conéctate con un cliente MySQL

MySQL   |  PostgreSQL   |  SQL Server

Puedes usar el cliente de línea de comandos de MySQL para conectarte a Cloud SQL. En esta página, se describe cómo conectar un cliente mysql a tu instancia de Cloud SQL, ya sea que lo ejecutes de forma local en tu máquina cliente, en una VM de Compute Engine o en Cloud Shell.

Nota: Para obtener información sobre cómo conectar un cliente a una instancia de Cloud SQL con el proxy de Cloud SQL Auth, consulta Conéctate con el proxy de Cloud SQL Auth. Si deseas obtener más información acerca de la conexión mediante una IP privada, consulta Configura la conectividad de IP privada.

Antes de comenzar

Antes de usar un cliente mysql para conectarte a tu instancia de Cloud SQL, haz lo siguiente:

• Crea una instancia de Cloud SQL y configura el usuario predeterminado.

  Consulta Crea instancias y Establece la contraseña para la cuenta de usuario predeterminada.

• De forma opcional, crea una instancia de VM de Compute Engine y, luego, conéctala a la instancia mediante SSH.

  Consulta Crea e inicia una instancia de VM, Acerca de las conexiones SSH, o Conéctate a las VMs de Windows mediante RDP.

• Decide cómo te conectarás a tu instancia.

  Para obtener información acerca de las opciones de conexión y cómo elegir una de ellas, consulta la sección Acerca de las opciones de conexión.

Usa un cliente MySQL en una máquina local o en una VM de Compute Engine

El uso de un cliente mysql para conectarte a tu instancia de Cloud SQL implica tres tareas de alto nivel:

1. Instala el cliente.
2. Configura el acceso a tu instancia de Cloud SQL.
3. Conéctate a tu instancia de Cloud SQL.

Instala el cliente

Para instalar el cliente de mysql, haz lo siguiente:

1. Descarga el servidor de la comunidad de MySQL para tu plataforma desde la página de descarga del servidor de la comunidad de MySQL.
   El servidor de la comunidad incluye el cliente MySQL.
2. Instala el servidor de la comunidad con las instrucciones que se muestran en la página de descargas.

Para obtener más información sobre cómo instalar MySQL, consulta la sección sobre cómo instalar y actualizar MySQL.

Configura el acceso a tu instancia de Cloud SQL

Para configurar el acceso a la instancia, haz lo siguiente:

1. Desde la máquina cliente o la instancia de VM de Compute Engine, usa ¿Cuál es mi IP? para ver la dirección IP de la máquina cliente.
2. Copia esa dirección IP.

3. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

   Ir a Instancias de Cloud SQL

4. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
5. Selecciona Conexiones en el menú de navegación de SQL.
6. En la sección Redes autorizadas, haz clic en Agregar red y, luego, ingresa la dirección IP de la máquina en la que está instalado el cliente.
   Nota: La dirección IP de la instancia y la dirección IP de cliente de mysql que autorizas deben ser la misma versión de IP, ya sea IPv4 o IPv6.
7. Haz clic en Listo y, luego, en Guardar en la parte inferior de tu página para guardar los cambios.
8. Conéctate a tu instancia, ya sea con SSL o sin SSL.

Conéctate a tu instancia de Cloud SQL sin encriptación

Nota: En este procedimiento se configura una conexión sin encriptar a tu base de datos. Si tu base de datos tiene datos sensibles, conéctate a la instancia con SSL.

Para conectarte a la instancia, sigue estos pasos:

1. Confirma que instalaste el cliente y configuraste el acceso a tu instancia.
2. Inicia el cliente mysql:

   mysql --host=INSTANCE_IP --user=root --password
   

3. Ingresa la contraseña.
4. Aparecerá el cuadro de MySQL.

Conéctate a tu instancia de Cloud SQL con SSL

Para conectarte mediante SSL, necesitas lo siguiente:

• Un certificado de autoridad certificada (CA) en un archivo server-ca.pem.
• Un certificado de clave pública del cliente en un archivo client-cert.pem.
• Una clave privada del cliente en un archivo client-key.pem

Si te falta un certificado de cliente y una clave privada correspondiente, crea un certificado de cliente nuevo.

Antes de comenzar, confirma que instalaste el cliente y configuraste el acceso a tu instancia.

Para conectarte a tu instancia con mediante SSL, haz lo siguiente:

1. Inicia el cliente mysql:

   mysql --ssl-ca=server-ca.pem --ssl-cert=client-cert.pem --ssl-key=client-key.pem \
                --host=INSTANCE_IP --ssl-mode=verify_ca --user=root --password
   

   Advertencia: No incluyas la marca --ssl-mode en el comando si usas un cliente MariaDB para conectarte a la instancia de MySQL. Usa el cliente desde el servidor de la comunidad de MySQL en su lugar.
2. Ingresa la contraseña.
3. En el cuadro de MySQL, ingresa el comando \s para verificar que tu conexión use SSL.
4. Busca la línea de resultado con SSL:

   ...
   SSL:                     Cipher in use is DHE-RSA-AES256-SHA
   ...
   

   Advertencia: Las versiones de cliente MySQL anteriores a 5.7.3 consideran las opciones --ssl como asesoramiento, y recurren silenciosamente a conexiones no encriptadas si el servidor no acepta una conexión encriptada. Para obtener más información, consulta Usa las conexiones encriptadas en el Manual de referencia de MySQL. A fin de evitar este problema, puedes configurar la instancia de modo que solo las conexiones SSL puedan establecerse en ella (si quieres obtener más información, consulta Configura conexiones SSL para instancias).

   Para obtener más información sobre la solución de problemas de conexión a través de IP, consulta Diagnostica problemas con las instancias de Cloud SQL.

Usa el cliente en Cloud Shell

Para conectarte a una instancia de Cloud SQL (solo IP pública), sigue estos pasos:

1. Ve a la consola de Google Cloud.

   Ve a la consola de Google Cloud.

2. Haz clic en el ícono de Cloud Shell a la derecha de la barra de herramientas.

   Cloud Shell tarda unos minutos en inicializarse.

3. En el mensaje de Cloud Shell, usa el cliente incorporado para conectarte a tu instancia de Cloud SQL:

   gcloud sql connect INSTANCE_ID \
   --user=root
   

4. Escribe la contraseña.

El comando gcloud sql connect no admite la conexión a una instancia de Cloud SQL mediante una IP privada ni mediante SSL/TLS. Para conectarte con la encriptación, instala y usa el proxy en Cloud Shell:

1. Instala el proxy (Linux de 64 bits) en el directorio /home/USER.
2. Inicia el proxy con la autenticación de la CLI de gcloud:

   ./cloud-sql-proxy INSTANCE_CONNECTION_NAME &

3. Conéctate a la base de datos mediante la conexión TCP:

   mysql -u USERNAME -p --host=127.0.0.1

¿Qué sigue?

• Obtén más información sobre cómo configurar una instancia con una dirección IP privada.
• Obtén más información sobre las opciones para conectarte a una instancia desde tu aplicación.
• Obtén más información sobre el cliente mysql.

Pruébalo tú mismo

Si es la primera vez que usas Google Cloud, crea una cuenta para evaluar el rendimiento de Cloud SQL en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

Probar Cloud SQL gratis